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PRÓLOGO 


CF, pronunciado C Sharp, es actualmente, junto con Java, uno de los lenguajes de 
programación más populares en Internet. Pero, además, apoyándose en la biblio- 
teca .NET, está disponible para el desarrollo de aplicaciones de propósito general, 
aplicaciones con interfaz gráfica, aplicaciones para Internet y aplicaciones para 
móviles. La idea fundamental de esta obra es dar a conocer estas facetas del len- 
guaje C#, profundizando en el alcance que tiene sobre la Web. 


En los últimos tiempos C y C++ han sido los lenguajes más utilizados en el 
desarrollo de aplicaciones en general. Ambos lenguajes proporcionan al progra- 
mador el nivel de abstracción preciso para abordar el desarrollo de cualquier apli- 
cación por compleja que sea, así como mecanismos de bajo nivel para utilizar las 
características más avanzadas de las plataformas sobre las que se desarrolla; pero, 
en general, el tiempo necesario para desarrollar una aplicación resulta largo com- 
parado con otros lenguajes como Visual Basic, que ofrecen además de facilidad, 
una elevada productividad en el desarrollo de aplicaciones, aunque, eso sí, sacrifi- 
cando la flexibilidad que los desarrolladores de C y C++ requieren. La solución 
que Microsoft da a este problema es el lenguaje denominado C#. Se trata de un 
lenguaje moderno orientado a objetos que permite desarrollar una amplia gama de 
aplicaciones para la plataforma Microsoft .NET. 


Más que otra cosa, el objetivo de C# es permitir a todos los desarrolladores en 
general, y a los de C y C++ en particular, abordar el desarrollo de aplicaciones 
complejas con facilidad y rapidez pero sin sacrificar la potencia y el control que 
ofrecen C y C++, Es un poco como tomar todas las cosas buenas de Visual Basic 
y añadirlas a C++, aunque recortando algunas de las tradiciones más ocultas y di- 
fíciles de conocer de C y C++. Esto elimina los errores de programación más co- 
munes en C/C++, Por ejemplo: 
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e Fl recolector de basura libera al programador del peso que conlleva el manejo 
manual de la memoria. 

e Todos los objetos creados dinámicamente así como las matrices son iniciados 
a cero, y aunque C# no inicia automáticamente las variables locales, el compi- 
lador avisará siempre que se intente utilizar una antes de iniciarla. 

e C# unifica el sistema de tipos permitiendo ver a cada uno de ellos en el len- 
guaje como un objeto. 


Resumiendo, C# es un lenguaje orientado a objetos seguro y elegante que 
permite a los desarrolladores construir un amplio rango de aplicaciones seguras y 
robustas que se ejecutan sobre .NET Framework. .NET Framework (que incluye 
entre otras cosas la biblioteca básica de .NET y el compilador C#) junto con otros 
componentes de desarrollo, como ASP.NET (formularios web y servicios web) y 
ADO.NET, forman un paquete de desarrollo denominado Microsoft Visual Studio 
que podemos utilizar para crear aplicaciones Windows tradicionales (aplicaciones 
de escritorio que muestren una interfaz gráfica al usuario) y aplicaciones para la 
Web. Para ello, este paquete proporciona un editor de código avanzado, diseñado- 
res de interfaces de usuario apropiados, depurador integrado y muchas otras utili- 
dades para facilitar un desarrollo rápido de aplicaciones. 


La palabra “Visual” hace referencia, desde el lado del diseño, al método que 
se utiliza para crear la interfaz gráfica de usuario si se dispone de la herramienta 
adecuada (con Microsoft Visual Studio se utiliza el ratón para arrastrar y colocar 
los objetos prefabricados en el lugar deseado dentro de un formulario) y desde el 
lado de la ejecución, al aspecto gráfico que toman los objetos cuando se ejecuta el 
código que los crea, objetos que formarán la interfaz gráfica que el usuario de la 
aplicación utiliza para acceder a los servicios que esta ofrece. Y “NET” hace refe- 
rencia al ámbito donde operarán nuestras aplicaciones web (Network - red). 


Para quién es este libro 


Este libro está pensado para aquellas personas que quieran aprender a desarrollar 
aplicaciones que muestren una interfaz gráfica al usuario, aplicaciones para acce- 
so a bases de datos y para Internet (páginas web). Para ello, ¿qué debe hacer el 
lector? Pues simplemente leer ordenadamente los capítulos del libro, resolviendo 
cada uno de los ejemplos que en ellos se detallan. 


Evidentemente, no vamos a enseñar a programar aquí, por eso es necesario 
tener algún tipo de experiencia con un lenguaje de programación orientado a obje- 
tos (C++, Visual Basic, Java, etc., son lenguajes orientados a objetos). Haber pro- 
gramado en .NET y con C# sería lo ideal, así como tener conocimientos de 
HTML y XML. Estos requisitos son materia de mis otros libros Microsoft C# - 


PRÓLOGO XXV 


Lenguaje y aplicaciones y Microsoft C# - Curso de programación, ambos edita- 
dos también por las editoriales RA-MA y Alfaomega Grupo Editor. 


Microsoft C# - Lenguaje y aplicaciones se centra en la programación básica: 
tipos, sentencias, matrices, métodos, ficheros, etc., y hace una introducción a las 
interfaces gráficas, a las bases de datos y a las aplicaciones para Internet, y Micro- 
soft C# - Curso de programación cubre la programación básica (expuesta en me- 
nor medida en el libro anterior) y la programación orientada a objetos (POO) en 
detalle: clases, clases derivadas, interfaces, espacios de nombres, excepciones, 
etc.; después, utilizando la POO, añade otros temas como estructuras dinámicas de 
datos, algoritmos de uso común, hilos (programación concurrente), etc. Este sí 
que es un libro de programación con C# en toda su extensión. Puede ver más deta- 
lles de cada uno de ellos en mi web: www. fjceballos.es. 


Cómo está organizado el libro 


El libro se ha estructurado en 20 capítulos más algunos apéndices que a continua- 
ción se relacionan. Los capítulos 1 y 2 nos introducen en .NET y en el desarrollo 
de aplicaciones de escritorio. Los capítulos 3 al 11 nos enseñan a desarrollar apli- 
caciones de escritorio que muestran una interfaz de ventanas al usuario. Los capí- 
tulos 12 al 14 cubren el enlace a datos, el acceso a bases de datos (ADO.NET), el 
lenguaje de consultas integrado (LINQ) y el acceso a bases de datos con Entity 
Framework. Y los capítulos 15 al 20 nos enseñan cómo desarrollar aplicaciones 
para Internet (ASP.NET) a base de formularios web, servicios web WCF y AJAX. 
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APÉNDICE C. INTERNACIONALIZACIÓN 
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Qué se necesita para utilizar este libro 


Este libro ha sido escrito utilizando el paquete Microsoft .NET Framework Softwa- 
re Development Kit (SDK) versión 4.5 que forma parte del entorno de desarrollo 
Microsoft Visual Studio 2012 que incluye todo lo necesario para escribir, construir, 
verificar y ejecutar aplicaciones .NET. Por lo tanto, basta con que instale en su má- 
quina Microsoft Visual Studio 2012, o superior, en cualquiera de sus versiones o, 
como alternativa, descargue desde http://www.microsoft.com/express/ los paquetes 
Visual Studio Express 2012 for Windows Desktop y for Web e instálelos (opcio- 
nalmente puede instalar también SOL Server 2012 Express, caso del autor). 


Nota: para probar las aplicaciones web se recomienda instalar el servidor de 
aplicaciones IIS (Internet Information Services) que incluye Windows (Inicio > 
Panel de control > Agregar y quitar programas > Windows). Esto tiene que ha- 
cerlo antes de instalar Microsoft Visual Studio 2012 o Visual Studio Express 2012 
for Web. 


Sobre los ejemplos del libro 


La imagen del CD de este libro, con las aplicaciones desarrolladas y el software 
para reproducirlas, puede descargarla desde: 
https://www.tecno-libro.es/ficheros/descargas/9788499644370.z1p 

La descarga consiste en un fichero ZIP con una contraseña ddd-dd-dddd-ddd-d 
que se corresponde con el ISBN de este libro (teclee los dígitos y los guiones). 
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Introducción 


e Introducción a Microsoft NET 


e Mi primera aplicación 


CAPÍTULO 1 


O F.J.Ceballos/RA-MA 


INTRODUCCIÓN A 
MICROSOFT .NET 


.NET Framework proporciona un entorno de programación orientada a objetos y 
un entorno de ejecución para construir aplicaciones de escritorio o para la Web. 
Consta de dos componentes principales: el CLR (Common Language Runtime), 
que es el motor de ejecución que controla las aplicaciones en ejecución, y la 
biblioteca de clases de .NET Framework, que proporciona una biblioteca de 
código probado y reutilizable para el desarrollo de aplicaciones, de la que forman 
parte Windows Forms y WPF, entre otras. 
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El CLR no es más que una máquina virtual que administra la ejecución del 
código de una aplicación, de ahí que al código gestionado por esta máquina se le 
denomine “código administrado”, a diferencia del resto de código (código más 
antiguo que no cumple todas las reglas del CLR pero que es compatible con este), 
que se conoce como “código no administrado”. Este motor de ejecución se puede 
también hospedar en servidores como Microsoft SQL Server e IIS (Internet 
Information Services). 


La biblioteca de clases de .NET es una biblioteca orientada a objetos que 
permite realizar tareas habituales de programación, como son la administración de 
cadenas, recolección de datos, conectividad de bases de datos y acceso a archivos, 
así como desarrollar los siguientes tipos de aplicaciones y servicios: 


e Aplicaciones de consola. 

e Aplicaciones Windows Forms (aplicaciones que muestran una interfaz 
gráfica). 

e Aplicaciones WPF (aplicaciones que muestran una interfaz gráfica 
enriquecida). 

e Aplicaciones de ASP.NET (aplicaciones para la Web). ASP.NET es una 
plataforma web que proporciona todos los servicios necesarios para compilar 
y ejecutar aplicaciones web. 

e Aplicaciones de Silverlight. Silverlight es un complemento de Microsoft que 
nos permite desarrollar aplicaciones enriquecidas para la Web. 

e Servicios Windows y servicios web. 


PLATAFORMA .NET 


Microsoft .NET extiende las ideas de Internet y sistema operativo haciendo de la 
propia Internet la base de un nuevo sistema operativo. En última instancia, esto 
permitirá a los desarrolladores crear programas que transciendan los límites de los 
dispositivos y aprovechen por completo la conectividad de Internet y sus aplica- 
ciones. Para ello proporciona una plataforma que incluye los siguientes compo- 
nentes básicos: 


e Herramientas de programación para crear los distintos tipos de aplicaciones 
especificados anteriormente. 


e Una infraestructura de servidores; por ejemplo Windows Server, SQL Server, 
Internet Information Services, etc. 


e Un conjunto de servicios (autentificación del usuario, almacén de datos, etc.) 
que actúan como bloques de construcción para el sistema operativo de Inter- 
net. Para entenderlo, compare los servicios con los bloques de Lego; al unir 
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bloques de Lego se pueden construir soluciones (una casa, un barco, etc.). De 
la misma forma, la unión de servicios web permite crear soluciones para rea- 
lizar una tarea concreta. 


Form Web Servicio web 
Protocolos: Utilidades: 


oe .NET Framework Visual Studio, 
; i Office, etc. 
etc. 


Servicios web 
.NET 

















Infraestructura 
de servidores 


Servicios web 
de terceros 





Servicios web 
propios 


e Software de dispositivos .NET para hacer posible una nueva generación de 
dispositivos inteligentes (ordenadores, teléfonos, consolas de juegos, etc.) que 
puedan funcionar en el universo .NET. 


e Experiencias .NET utilizadas por los usuarios finales; por ejemplo, servicios 
que pueden leer las características del dispositivo que el usuario final está uti- 
lizando para acceder y activar así la interfaz más adecuada. 


.NET Framework 


Claramente, se requiere una infraestructura, no solo para facilitar el desarrollo de 
aplicaciones, sino también para hacer que el proceso de encontrar un servicio web 
e integrarlo en una aplicación resulte transparente para usuarios y desarrolladores: 
.NET Framework proporciona esa infraestructura, según se puede ver en la figura 
siguiente. 


.NET Framework proporciona un entorno unificado para todos los lenguajes 
de programación. Microsoft ha incluido en este marco de trabajo los lenguajes CF, 
Visual Basic, C++ y F#, y, además, mediante la publicación de la especificación 
común para los lenguajes, ha dejado la puerta abierta para que otros fabricantes 
puedan incluir sus lenguajes (Object Pascal, Perl, Python, Fortran, Prolog, Cobol, 
PowerBuilder, etc., ya han sido escritos para .NET). Quizás, lo más atractivo de 
todo esto es la capacidad que ahora tenemos para escribir una misma aplicación 
utilizando diferentes lenguajes. 
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Para que un código pueda interactuar con cualquier otro independientemente 
del lenguaje utilizado, NET Framework proporciona la “especificación común 
para los lenguajes” (CLS - Common Language Specification) que define las carac- 
terísticas fundamentales del lenguaje y las reglas de cómo deben ser utilizadas. 
Por ejemplo, el CLS define un conjunto de tipos de datos comunes (Common Ty- 
pe System o CTS) que indica qué tipos de datos se pueden manejar, cómo se de- 
claran y cómo se utilizan. De esta forma, aunque cada lenguaje .NET utilice una 
sintaxis diferente para cada tipo de datos, por ejemplo, C# utiliza int para un nú- 
mero entero de 32 bits y Visual Basic utiliza Integer, estos nombres no son más 
que sinónimos del tipo común System.Int32. De esta forma, las bibliotecas que 
utilicen datos definidos en el CTS no presentarán problemas a la hora de ser utili- 
zadas desde cualquier otro código escrito en la plataforma .NET, permitiendo así 
la interoperabilidad entre lenguajes. 


[A AA 
A PA 





También, además del CLR, el CLS y los lenguajes, forman parte de este mar- 
co de trabajo las bibliotecas que nos permiten crear aplicaciones Windows Forms 
(WinForms) o aplicaciones WPF (Windows Presentation Foundation), la plata- 
forma de desarrollo web ASP.NET, la biblioteca para desarrollo de servicios web, 
la biblioteca ADO.NET o ADO.NET Entity Framework para acceso a bases de 
datos, la combinación de extensiones al lenguaje y bibliotecas (LINQ y sus pro- 
veedores de datos) que permiten expresar como parte del lenguaje consultas a da- 
tos, etc. Finalmente, para facilitar el desarrollo de aplicaciones utilizando estas 
bibliotecas disponemos del entorno de desarrollo integrado Visual Studio. 
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Aplicaciones de cliente 


Para desarrollar aplicaciones basadas en Windows que se ejecuten localmente en 
los equipos de los usuarios podemos hacerlo mediante Windows Forms o median- 
te WPF (biblioteca de clases base de .NET para el desarrollo de interfaces gráficas 
de usuario vectoriales avanzadas). 


Un formulario Windows no es más que una ventana que el desarrollador re- 
llena con controles, para crear aplicaciones que muestran una interfaz gráfica al 
usuario, y con código, para procesar los datos. 


Para diseñar aplicaciones que utilicen interfaces gráficas, además de la biblio- 
teca Windows Forms, .NET proporciona otra biblioteca de clases denominada 
WPF. Esta biblioteca no ha sido creada para sustituir a Windows Forms, sino que 
simplemente proporciona otras posibilidades para el desarrollo de aplicaciones 
cliente; por ejemplo, facilita el desarrollo de aplicaciones en el que estén implica- 
dos diversos tipos de medios: vídeo, documentos, contenido 3D, secuencias de 
imágenes animadas, o una combinación de cualesquiera de los anteriores, así co- 
mo el enlace con los datos. 


Aplicaciones web 


Podríamos decir que .NET conduce a la tercera generación de Internet, si 
pensamos que la primera generación consistió en trabajar con información estática 
que podía ser consultada a través de exploradores como si de un tablón de noticias 
se tratara, que la segunda generación se basó en que las aplicaciones pudieran 
interaccionar con las personas (sirva como ejemplo los famosos carros de la 
compra) y que la tercera generación se ha caracterizado por aplicaciones que 
puedan interaccionar con otras aplicaciones; por ejemplo, para programar una 
reunión de negocios, su aplicación de contactos puede interaccionar con su 
aplicación de calendario, que, a su vez, Interaccionará con una aplicación de 
reserva de billetes para viajar en avión, que consultará a su aplicación preferencias 
de usuario, por si tuviera que cancelar alguna actividad ya programada. 


Precisamente, el principio de .NET es que los sitios web aislados de hoy en 
día y los diferentes dispositivos trabajen conectados a través de Internet para 
ofrecer soluciones mucho más ricas. Esto se ha conseguido gracias a la aceptación 
de los estándares abiertos basados en XML (Extensible Markup Languaje — len- 
guaje extensible para describir documentos). De esta manera, Internet se ha 
convertido en una fuente de servicios, no solo de datos. 


XML no es, como su nombre podría sugerir, un lenguaje de marcado; es un 
metalenguaje que nos permite definir lenguajes de marcado adecuados para usos 
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determinados. Hay que desterrar ideas como que “XML es HTML mejorado”. 
XML es un estándar para la descripción y el intercambio de información, princi- 
palmente en Internet. 


HTML es un lenguaje utilizado para definir la presentación de información en 
páginas web. Gracias a HTML hemos podido combinar texto y gráficos en una 
misma página y crear sistemas de presentación complejos con hiperenlaces entre 
páginas. Pero HTML no es útil en lo que se refiere a la descripción de informa- 
ción; XML sí. Por ejemplo, se puede utilizar HTML para dar formato a una tabla, 
pero no para describir los elementos de datos que componen la misma. 


En definitiva, Internet y XML han dado lugar a una nueva fase de la informá- 
tica en la que los datos del usuario residen en Internet, no en un ordenador perso- 
nal, y se puede acceder a ellos desde cualquier ordenador de sobremesa, portátil, 
teléfono móvil o agenda de bolsillo (PDA: Personal Digital Assistant). Ello se 
debe fundamentalmente a que XML ha hecho posible que se puedan crear aplica- 
ciones potentes, para ser utilizadas por cualquiera, desde cualquier lugar. En el co- 
razón del nuevo enfoque de desarrollo está el concepto de servicio web (servicio 
web XML o WCF). Por ejemplo, en este contexto, el software no se instala desde 
un CD, sino que es un servicio, como la televisión por pago, al que suscribirse a 
través de un medio de comunicación. 





Un servicio web es una aplicación que expone sus características de manera 
programática sobre Internet, o en una intranet, utilizando protocolos estándar de 
Internet como HTTP (Hypertext Transfer Protocol — protocolo de transmisión de 
hipertexto) para la transmisión de datos y XML para el intercambio de los mis- 
mos. Pues bien, .NET ha sido desarrollado sobre el principio de servicios web. 
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Finalmente, hay que decir que para facilitar la creación de aplicaciones web 
disponemos de la plataforma ASP.NET o bien de la tecnología Silverlight (un 
competidor directo de Flash). 


ADO.NET 


ADO.NET (ActiveX Data Objects para .NET) incluye un conjunto de clases que 
proporcionan servicio de acceso a bases de datos. 


Biblioteca de clases base 


.NET Framework incluye clases, interfaces y tipos que aceleran y optimizan el 
proceso de desarrollo y proporcionan acceso a la funcionalidad del sistema. 


Entorno de ejecución común de los lenguajes 


.NET Framework proporciona un entorno de ejecución llamado CLR (Common 
Language Runtime; es la implementación de Microsoft de un estándar llamado 
Common Language Infrastructure o CLI, creado y promovido por Microsoft, re- 
conocido mundialmente por el ECMA). Se trata de una máquina virtual que ad- 
ministra la ejecución del código y proporciona servicios que hacen más fácil el 
proceso de desarrollo (en esencia, estamos hablando de una biblioteca utilizada 
por cada aplicación .NET durante su ejecución). 


El proceso de ejecución de cualquier aplicación incluye los pasos siguientes: 


Diseñar y escribir el código fuente. 

Compilar el código fuente a código intermedio. 
Compilar el código intermedio a código nativo. 
Ejecutar el código nativo. 


A NS 


Puesto que .NET Framework es un entorno de ejecución multilingüe, soporta 
una amplia variedad de tipos de datos y de características del lenguaje, que serán 
utilizadas en la medida que el lenguaje empleado las soporte y que el desarrolla- 
dor adapte su código a las mismas. Esto es, es el compilador utilizado, y no el 
CLR, el que establece el código que se utiliza. Por lo tanto, cuando tengamos que 
escribir un componente totalmente compatible con otros componentes escritos en 
otros lenguajes, los tipos de datos y las características del lenguaje utilizado deben 
estar admitidos por la especificación de lenguaje común (CLS). 


Cuando se compila el código escrito, el compilador lo traduce a un código in- 
termedio denominado MSIL (Microsoft Intermediate Language) o simplemente 
IL, correspondiente a un lenguaje independiente de la unidad central de proceso 
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(UCP). Esto quiere decir que el código producido por cualquier lenguaje .NET 
puede transportarse a cualquier plataforma (Intel, Sparc, Motorola, etc.) que tenga 
instalada una máquina virtual de .NET y ejecutarse. Pensando en Internet esta ca- 
racterística es crucial ya que esta red conecta ordenadores muy distintos. 


IL incluye instrucciones para cargar, iniciar y llamar a los métodos de los ob- 
jetos, así como para operaciones aritméticas y lógicas, control del flujo, acceso di- 
recto a memoria, manipulación de excepciones y otras operaciones. 


Código 
+ Compilador EZ | intermedio 


(assembly) 





CA, VB, C++, 


otros lenguajes .NET .exe o .dll 


La siguiente figura muestra el aspecto que tiene el código intermedio de una 
aplicación. Este código puede obtenerlo a través del desensamblador ¡ldasm.exe 
que viene con la plataforma .NET. 


" Saludo.Forml:InitializeComponent: void!) 
Buscar Buscar siguiente 
-method private hidebysig instance void InitializeComponent() cil managed 


/f Code size 403 (0x193) 
.maxstack 7 
1L_0880: nop 
IL_0091: ldarg.8 
11_0002: newobj instance void [System.Windows.Forms]System.Windows.Forms.Button::.ctor() 
1L_0007: stfld class [System.Windows.Forms]System.Windows.Forms.Button Saludo.Form1::btS 
IL_088c: Idarg.8 
IL_9060d: newobj instance void [System.Windows.Forms]System.Windows.Forms.Label::.ctor() 
1L_0012: stfld class [System.Windows.Forms]System.Windows.Forms.Label Saludo.Form1::etSa: 
1L_0017: ldarg.8 
11_0018: call instance void [System.Windows.Forms]System.Windows.Forms.Control : :Suspend! 
1L_081d: nop 
IL_661e: ldarg.8 
IL_001f: 1dfFld class [System.Windows.Forms]System.Windows.Forms.Button Saludo.Form1::btS. 
11_0024: 1dc.i4.s 53 
11_0026: 1dc.i4.s 100 
11_0028: newobj instance void [System.Drawing]System.Drawing.Point::.ctor(int32, 

int32) 
1L_002d: callvirt instance void [System.Vindows.Forms]System.Windows.Forms.Control::set_Loc. _ 
Tr ARII- nan 


«| uE + 





Cuando el compilador produce IL también produce metadatos: información 
que describe cada elemento manejado por el CLR (tipo, método, etc.). Esto es, el 
código a ejecutar debe incluir esta información para que el CLR pueda proporcio- 
nar servicios tales como administración de memoria, integración de múltiples len- 
guajes, seguridad, control automático del tiempo de vida de los objetos, etc. Tanto 
el código intermedio como los metadatos son almacenados en un fichero ejecuta- 
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ble y portable (.exe o .dll), denominado ensamblado (assembly en inglés), que 
permite que el código se describa a sí mismo, lo que significa que no hay necesi- 
dad de bibliotecas de tipos o de lenguajes de definición de interfaces. 


Un ensamblado es la unidad fundamental de construcción de una aplicación 
.NET y básicamente incluye dos partes diferenciadas: el manifiesto y el código IL. 
El manifiesto incluye los metadatos que describen completamente los componen- 
tes en el ensamblado (versión, tipos, dependencias, etc.) y el código describe el 
proceso a realizar. 


Antes de que el código intermedio pueda ser ejecutado, debe ser convertido 
por un compilador JIT (Just in Time: al instante) a código nativo, que es código 
especifico de la UCP del ordenador sobre el que se está ejecutando el JIT. 


Código e. N Código 
IL A nativo 





Máquina virtual 


La máquina virtual no convierte todo el código MSIL a código nativo y des- 
pués lo ejecuta, sino que lo va convirtiendo bajo demanda con el fin de reducir el 
tiempo de ejecución; esto es, cada método es compilado a código nativo cuando 
es llamado por primera vez para ser ejecutado, y el código nativo que se obtiene 
se guarda para que esté accesible para subsiguientes llamadas. Este código nativo 
se denomina “código administrado” si cumple la especificación CLS, en otro caso 
recibe el nombre de “código no administrado”. 


La máquina virtual (el CLR) proporciona la infraestructura necesaria para 
ejecutar el código administrado así como también una variedad de servicios que 
pueden ser utilizados durante la ejecución (administración de memoria —incluye 
un recolector de basura para eliminar un objeto cuando ya no esté referenciado-, 
seguridad, interoperatividad con código no administrado, soporte multilenguaje 
para depuración, soporte de versión, etc.). 


El código no administrado es código creado sin tener en cuenta la especifica- 
ción de lenguaje común (CLS). Este código se ejecuta con los servicios mínimos 
del CLR (por ejemplo, sin recolector de basura, depuración limitada, etc.). Los 
componentes COM, las interfaces ActiveX y las funciones de la API Win32 son 
ejemplos de código no administrado. 
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Código 
fuente 


MSIL 


Código 
nativo 


Servicios del sistema operativo 





La utilidad ngen.exe (Native Image Generator) es un generador de código na- 
tivo. Permite crear una imagen en código nativo de los ensamblados especifica- 
dos: ngen [opciones] [ensamblado [...]1. 


.NET Framework y COM+ 


El software reutilizable no es una idea nueva. El modelo COM (Component Ob- 
ject Model) introdujo el concepto de “componente”: un fragmento de código reuti- 
lizable en cualquier aplicación Windows. OLE (Object Linking and Embedding) 
fue el primer lugar en el que los desarrolladores experimentaron COM. 


El problema con COM, desde una perspectiva de desarrollo, era que requería 
escribir muchas interfaces para convertir la lógica de negocio de una aplicación en 
un componente reutilizable. Además de eso, COM también obligaba a los desarro- 
lladores a manejar manualmente complejidades como limpieza de la memoria 
cuando un componente no se va a utilizar más, recuento del número de veces que 
un componente está en uso, establecimiento y eliminación de hilos y procesos, y 
manejo de versiones, lo que se traducía en errores de aplicación, fallos de sistema 
y el notorio “infierno de las DLL”. Por otra parte, el escribir esta infraestructura 
COM no permitía a los desarrolladores centrarse en la lógica de negocio. 


Uno de los objetivos iniciales de NET Framework fue hacer el desarrollo de 
COM más fácil, automatizando todo lo que es y supone actualmente COM, in- 
cluido el recuento de referencias, descripción de la interfaz y registro. En el caso 
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de componentes del NET Framework, el CLR automatiza esas características; los 
componentes se describen a sí mismos y pueden ser por tanto instalados sin nece- 
sidad de inscribirlos en el registro de Windows. 


COM+ es el nombre de COM tras combinarlo con MTS (Microsoft Transac- 
tion Server) y DCOM (Distributed COM). Proporciona un conjunto de servicios 
orientados principalmente al desarrollo de aplicaciones para la capa media de una 
aplicación (capa de lógica de negocio; las otras dos capas son la de presentación y 
la de datos), enfocados a proporcionar fiabilidad y escalabilidad para aplicaciones 
distribuidas de gran escala. Estos servicios son complementarios de los servicios 
de programación del .NET Framework, ya que las clases del .NET Framework 
proporcionan acceso directo a ellos. 


El problema con COM+ (igual que con CORBA o RMI) es que no se pueden 
escalar a Internet. El acoplamiento entre el servicio y el consumidor del servicio 
es muy estrecho, lo que significa que si la implementación en un lado cambia, el 
otro lado falla. Para evitar esto, con .NET Framework los servicios web se aco- 
plan de manera suelta. Técnicamente, esto se traduce en utilizar una tecnología 
asíncrona, basada en mensajería utilizando protocolos web y XML. 


Los sistemas de mensajes envuelven las unidades fundamentales de comuni- 
cación (los mensajes) en paquetes que se autodescriben y que los propios sistemas 
ponen en la red, con la única suposición de que los receptores los entenderán. En 
cambio, con un sistema de objetos distribuidos, el emisor hace muchas suposicio- 
nes acerca del receptor, como activar la aplicación, llamar a sus interfaces, apagar 
la aplicación, etc. 


Visual Studio 


Visual Studio es un conjunto completo de herramientas de desarrollo para cons- 
truir aplicaciones web, servicios web, aplicaciones Windows o de escritorio y 
aplicaciones para dispositivos móviles. El entorno de desarrollo integrado que 
ofrece esta plataforma con todas sus herramientas y con la biblioteca de clases 
.NET Framework es compartido en su totalidad por Visual C#, Visual Basic y Vi- 
sual C++, permitiendo así crear con facilidad soluciones en las que intervengan 
varios lenguajes y en las que el diseño se realiza separadamente respecto a la pro- 
gramación. 


CAPÍTULO 2 
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MI PRIMERA APLICACIÓN 


Se puede desarrollar una aplicación que muestre una interfaz gráfica utilizando 
como herramientas Microsoft .NET Framework SDK (proporciona, entre otras co- 
sas, la biblioteca de clases .NET y el compilador de C#) y un simple editor de tex- 
to, o bien utilizando un entorno de desarrollo integrado (EDI). En el primer caso 
hay que escribir el código fuente línea a línea, para después, desde la línea de ór- 
denes, compilarlo, ejecutarlo y depurarlo. Lógicamente, escribir todo el código 
necesario para crear la interfaz gráfica de la aplicación es una tarea repetitiva que, 
de poder mecanizarse, ahorraría mucho tiempo en la implementación de una apli- 
cación y permitiría centrarse más y mejor en resolver los problemas relativos a su 
lógica y no a su aspecto. Justamente esto es lo que aporta Visual Studio, o bien, en 
su defecto, la versión de Visual CH Express. 


MICROSOFT VISUAL STUDIO 


Visual Studio permite diseñar la interfaz gráfica de una aplicación de manera vi- 
sual, sin más que arrastrar con el ratón los controles que necesitemos sobre la ven- 
tana destino de los mismos. Una rejilla o unas líneas de ayuda mostradas sobre la 
ventana nos ayudarán a colocar estos controles y a darles el tamaño adecuado, y 
una página de propiedades nos facilitará la modificación de los valores de las pro- 
piedades de cada uno de los controles. Todo lo expuesto lo realizaremos sin tener 
que escribir ni una sola línea de código. Después, un editor de código inteligente 
nos ayudará a escribir el código necesario y detectará los errores sintácticos que 
introduzcamos, y un depurador nos ayudará a poner a punto nuestra aplicación 
cuando lo necesitemos. 


Como ejemplo, vamos a realizar una aplicación Windows denominada Salu- 
do, que presente una interfaz al usuario como la de la figura siguiente: 
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> 


ul Saludo lala) 





¡¡¡Hola mundo!!! 





| Haga clic aquí 

















Para empezar, arranque Visual Studio o, en su defecto, Visual C# Express. Se 
visualizará una ventana como la siguiente: 





DO Pigaan r E- 
ARCHIVO EDITAR YER DEPURAR EQUIPO SQL HERRAMIENTAS VMWABE PRUEBA ARQUITECTURA ANALIZAR VENTANA AYUDA 
n-ap b Aduntar.. + i 

a 
g > Explorador de zolucor -4x 
E + 
+] i ) COMENZAR 
: Ultimate 2012 


Pantalla de bienvenida 


Iniciar 





è w9 Noveda: 
3 
OS 67 PRE: 
5 f% Administrar sus proyectos en la nube 
> # sasikat 
y A s : 
rs 4, 
Resultado -9x 


Im 
ë 


Mostrar resultados desde VMware 


Operaciones de herramientas de datos Lista de errores Resultado Vista de dases 





¿Cuáles son los siguientes pasos para desarrollar una aplicación Windows? En 
general, para construir una aplicación de este tipo con Visual Studio, siga los pa- 
sos indicados a continuación: 


1. Cree un nuevo proyecto (una nueva aplicación), entendiendo por proyecto un 
conjunto de elementos en forma de referencias, conexiones de datos, carpetas 
y ficheros necesarios para crear la aplicación (mientras que un proyecto nor- 
malmente contiene varios elementos, una solución puede contener varios pro- 
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yectos). Una vez creado el proyecto/solución, Visual Studio mostrará una pá- 
gina de diseño con un formulario vacío por omisión. 


2. Dibuje los controles sobre el formulario. Los controles serán tomados de una 


caja de herramientas. 


3. Defina las propiedades del formulario y de los controles. 


4. Escriba el código para controlar los eventos que considere de cada uno de los 


objetos. 


5. Guarde, compile y ejecute la aplicación. 


6. Opcionalmente, utilice un depurador para poner a punto la aplicación. 


Crear un nuevo proyecto 


Para crear un nuevo proyecto, diríjase a la barra de menús y ejecute Archivo > 
Nuevo proyecto. En el diálogo que se visualiza, seleccione el tipo de proyecto Vi- 
sual C# > Windows, la plantilla Aplicación de Windows Forms, el nombre Saludo 
y haga clic en el botón Aceptar: 





Nuevo proyecto 





b Reciente «NET Framework 4.5 ~ Ordenar por: Predeterminado > 
4 Instalado cs 
[ ] Aplicación de Windows Forms Visual CF 
4 Plantillas es 
Þ Visual Basic |m Aplicación WPF Visual C# 
a Visual C# cs 
RSS EN Aplicación de consola Visual C# 
Web p ce 
Le Biblioteca de clases Visual C# 
b Office $ 
Cloud rl 
¿Ny Biblioteca de clases portable Visual C# 
Prueba s 
A y ce 
6 Aplicación de explorador WPF Visual C# 
b En línea e v 
ars 
Nombre: Saludo 
Ubicación: c\users\fjceballos\documents\visual studio 2012\Projects 


Nombre de la solución: 








Tipo: Visual C# 


Proyecto para crear una aplicación con 
una interfaz de usuario de Windows 
Forms 


- | Examinar... | 


[C] Crear directorio para la solución 





[C] Agregar al control de código fuente 


[_ Aceptar] | Cancelar | 














Obsérvese que se ha elegido la carpeta donde se almacenará el proyecto. Esta 
tarea puede posponerse sin que afecte al desarrollo de la aplicación. Ahora bien, si 
desea que esta tarea se realice automáticamente en el momento de crear el proyec- 
to, caso del autor, ejecute Herramientas > Opciones, seleccione la opción Proyec- 
tos y soluciones y marque la casilla Guardar los proyectos nuevos al crearlos. 
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También, en la parte superior de la ventana hay una lista que le permitirá se- 
leccionar la versión de .NET Framework que desea utilizar. 


Después de crear una nueva aplicación Windows, el entorno de desarrollo Vi- 
sual Studio mostrará un formulario, Form1, en el diseñador. También pondrá a 
nuestra disposición una caja de herramientas con una gran cantidad de controles 
listos para ser incluidos en un formulario. 








O saco - Micros Visual St el i Pia O 
ARCHIVO EDITAR VER PROYECTO COMPILAR DEPURAR EQUIPO SQL HERRAMIENTAS VMWARE PRUEBA ARQUITECTURA ANALIZAR VENTANA AYUDA 
B-QR Y b Iniciar > Debug » M, 
2 metoj e x > Explorador de soluðones -4x 
H à 0:08 oF 
2 algíg : e 4 p- 
2 r 
g ma GI Solución Saludo" (1 proyecto) 
Ro Puntero 4 E Saludo 
© Burton > 5 Properties 
CheckBos > ea References 
EE CheckedlistBox $ D Appicong 
T Comboðor a fomio 
Date limebiccer > D Forml Designers 
A Labe r b 4 Form 
A  UskLabel pe > e Progrema 
E Lema 
E Lali 
6 
O MasiedTexBoj 
E MomhCalenda y 
ke Notftyicon Explorador de selunones Vista de dases 
I NumercUpDow ds SER 
E Picuretor 
E ProgressBar Formi System. Windows Forma Form 
© radioButton EOF A 
E BhTeotBo Opacity 100% 
E Taito Sl Padding 0,000 
ta Toop MMT "o 
À MghtToLettLayout False 
E TreeView 
Showicon True 
El Weblromer Resultados + 9x  Sowintasibar True 
b Contenedores e E Sue 300; 300 
» Generación de biformes Mostrar resultados desde VMware € SeeGriostyle NA 
b Menús y barras de herramientas StanPoution Windows ODetaulttor 
» Datos Ta 
» Componentes Tat Form1 
D Impresión TardArrs Fake 
» Cuadros de dislogo Text 
$ Interoocrabididad WPF s Texto asociado al control 
Explorador. dro deh. Explorador.  Operadones de herramientas de dalos Lista de errores Resultados 


Otra característica interesante de este entorno de desarrollo es la ayuda diná- 
mica que facilita. Se trata de un sistema de ayuda sensible al contexto; esto es, au- 
tomáticamente se mostrará la ayuda relacionada con el elemento seleccionado o 
ayuda para completar el código mientras lo escribimos. Por ejemplo, observe en la 
ventana de Propiedades, en la esquina inferior derecha, la ayuda relativa a la pro- 
piedad seleccionada. 


En la esquina superior derecha también se localiza otra ventana con varias 
páginas: explorador de soluciones, vista de clases, etc.; en la figura siguiente ve- 
mos el Explorador de soluciones: 
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Explorador de soluciones SENA 
6 0-05 op ” 
Buscar en el Explorador de soluciones (Ctrl+”) p~ 


E] Solución 'Saludo' (1 proyecto) 
4 Saludo 
b Æ Properties 
4 5] References 
sa Microsoft.CSharp 
sa System 
sa System.Core 
sa System.Data 
sa System.Data.DataSetExtensions 
=a System.Deployment 
sa System.Drawing 
sa System.Windows.Forms 
sa System.Xml 
sa System.Xml.Ling 
{A App.config 
4 [E] Form1.cs 
4 1) Form1.Designer.cs 
D g Forml1 
D &g Forml 


> œ Program.cs 


El explorador de soluciones muestra el nombre de la solución (una solución 
engloba uno o más proyectos), el nombre del proyecto (un proyecto administra los 
ficheros que componen la aplicación) y el de todos los formularios y módulos; en 
nuestro caso, observamos un formulario, denominado Forml, descrito por los fi- 
cheros de código Forml.cs y Forml.Designer.cs; el primero es el utilizado por el 
programador para escribir el código y el segundo, el utilizado por el diseñador de 
formularios. También se observa un nodo References que agrupa las referencias a 
las bibliotecas de clases de objetos que utilizará la aplicación en curso; podemos 
añadir nuevas referencias a otras bibliotecas haciendo clic con el botón secundario 
del ratón sobre ese nodo. 


Así mismo, en su parte superior, muestra una barra de botones que permiten 
ver el código, mostrar todos los archivos, la ventana de propiedades, etc. Por 
ejemplo, si estamos viendo el diseñador de formularios y hacemos clic en el botón 
Ver código, la página de diseño será sustituida por el editor de código, como se 
puede observar en la figura siguiente: 
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DO suo mi y Pf m0 Xx 
ARCHIVO EDITAR YER PROYECTO COMPILAR DEPURAR EQUIPO SQL HERRAMIENTAS VMWABE PRUEBA  ABQUITECTURA ANALIZAR VENTANA AYUDA 
o- B-a” ?- b Iniciar > Obo >» MN, bh PD A 
T EE a E 
2 CEREA to < oio +» Explorador de soludones -%x 
$ SSNs -19 . A .:-009 o 
s 1 Susing System; e x P- 
g E F ¿ -En a 
5 2 Pi System.Collections.Generic; T Solución Saludo" (1 proyecto) 
3 using System.ComponentModel; 4 1% Saludo 
4 using System.Data; > # Properties 
5 using System.Drawing; > oa References 
6 using System.Lingq; D nc 


x E 7 A 4 Mfomia 
using System.Text; > D FormL Designers 


using System.Threading.Tasks; D FormLresx 
using System. Windows .Forms; D Ag Formi 
> es Programe 


IDOD OP OPEL 


namespace Saludo 


-| public partial class Formi : Form 
{ Explorador de soluoonet Vista de dases 


pa pa 
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Una característica digna de resaltar del editor de Visual Studio es la incorpo- 
ración de bloques de código contraíbles. En la figura superior podemos ver varios 
de estos bloques; si hacemos clic en el nodo —, contraeremos el bloque y el nodo 
se convertirá en otro + que permitirá expandir de nuevo el bloque. 


Otra característica del editor es la finalización y el formato de código automá- 
ticos. Por ejemplo, al escribir un método, el editor mostrará automáticamente la 
ayuda en línea de la palabra clave (public, void, int, etc.) que intenta escribir; si 
escribimos una sentencia if, exactamente igual. Puede personalizar las caracterís- 
ticas del editor ejecutando Herramientas > Opciones > Editor de texto. 


Si cuando se está visualizando el explorador de soluciones desea mostrar la 
vista de clases de su aplicación, ejecute la opción Vista de clases del menú Ver, o 
bien haga clic en la pestaña Vista de clases si esta está presente. Esta ventana, en 
su parte superior, muestra las clases que componen la aplicación, y en su parte in- 
ferior, los métodos pertenecientes a la clase seleccionada. 
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Expandiendo el nodo del proyecto, vemos, en primer lugar, el espacio de 
nombres al que pertenecen los elementos de la aplicación: Saludo (un espacio de 
nombres define un ámbito). Si ahora expandimos este otro nodo, veremos que in- 
cluye una clase, la que define el objeto Form1, y si expandimos a su vez este no- 
do, podremos observar su clase base. En la figura podemos ver seleccionada la 
clase Forml, que define un constructor, Forml, y los métodos Dispose, Initiali- 
zeComponent y components. 


El formulario 


El formulario es el plano de fondo para los controles. Después de crear un nuevo 
proyecto, la página de diseño muestra uno como el de la figura siguiente. Lo que 
ve en la figura es el aspecto gráfico de un objeto de la clase Form1. Para modifi- 
car su tamaño ponga el cursor del ratón sobre alguno de los lados del cuadrado 
que lo rodea y arrastre en el sentido deseado. 
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Si ahora ejecutamos este programa, para lo cual podemos pulsar las teclas 
Ctrl+F5 o elegir la orden correspondiente del menú Depurar, aparecerá sobre la 
pantalla la ventana, con el tamaño asignado, y podremos actuar sobre cualquiera 
de sus controles, o bien sobre las órdenes del menú de control, para minimizarla, 
maximizarla, moverla, ajustar su tamaño, etc. Esta es la parte que el diseñador de 
Visual C# realiza por nosotros y para nosotros; pruébelo. Finalmente, para cerrar 
la ejecución de la aplicación disponemos de varias posibilidades: 


1. Hacer clic en el botón ES que cierra la ventana. 


2. Hacer un doble clic en el icono situado a la izquierda en la barra de título de 
la ventana. 


3. Activar el menú de control de la ventana Form1 y ejecutar Cerrar. 
Pulsar las teclas 4/1+F4. 


Dibujar los controles 


En Visual C# disponemos fundamentalmente de dos tipos de objetos: ventanas y 
controles. Las ventanas son los objetos sobre los que se dibujan los controles co- 
mo cajas de texto, botones o etiquetas, dando lugar a la interfaz gráfica que el 
usuario tiene que utilizar para comunicarse con la aplicación y que genéricamente 
denominamos “formulario”. 


Para añadir un control a un formulario, utilizaremos la caja de herramientas 
que se muestra en la figura siguiente. Cada herramienta de la caja crea un único 
control. El significado de los controles más comunes se expone a continuación. 


Puntero. El puntero no es un control. Se utiliza para seleccionar, mover y 
ajustar el tamaño de los objetos. 
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Label. Una etiqueta permite mostrar un texto de una o más líneas que no pue- 
da ser modificado por el usuario. Son útiles para dar instrucciones al usuario. 


LinkLabel. Se trata de una etiqueta de Windows que puede mostrar hiper- 
vínculos. 


Button. Un botón de pulsación normalmente tendrá asociada una orden con él. 
Esta orden se ejecutará cuando el usuario haga clic sobre el botón. 


Cuadro de herramientas 
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TextBox. Una caja de texto es un área dentro del formulario en la que el usua- 
rio puede escribir o visualizar texto. 


MaskedTextBox. Una caja de texto mejorada que soporta una sintaxis declara- 
tiva para aceptar o rechazar la entrada del usuario. 


MenusStrip. Permite añadir una barra de menús a una ventana. 


CheckBox. Una casilla de verificación se utiliza para seleccionar una opción. 
Utilizando estos controles se pueden elegir varias opciones de un grupo. 


RadioButton. El control botón de opción se utiliza para seleccionar una op- 
ción entre varias. Utilizando estos controles se puede elegir una opción de un gru- 
po de ellas. 


GroupBox. Un marco se utiliza para realzar el aspecto del formulario. Tam- 
bién los utilizamos para formar grupos de botones de opción, o bien para agrupar 
controles relacionados entre sí. 


PictureBox. Una caja de imagen se utiliza normalmente para mostrar gráficos 
de un fichero de mapa de bits, metarchivo, icono, JPEG, GIF o PNG. 


Panel. Control que actúa como contenedor de otros controles. 


FlowLayoutPanel. Representa un panel que coloca dinámicamente su conte- 
nido vertical u horizontalmente. 


TableLayoutPanel. Representa un panel que coloca dinámicamente su conte- 
nido en una rejilla de filas y columnas. 


DataGridView. Proporciona una tabla para visualizar los datos de una forma 
personalizada. 


ListBox. El control lista fija (lista desplegada) contiene una lista de elementos 
de la que el usuario puede seleccionar uno o varios elementos. 


CheckedListBox. Se trata de un control lista fija en el que se muestra una casi- 
lla de verificación a la izquierda de cada elemento. 


ComboBox. El control lista desplegable combina una caja de texto y una lista 
desplegable. Permite al usuario escribir lo que desea seleccionar o elegir un ele- 
mento de la lista. 


ListView. El control vista de lista muestra una colección de elementos que se 
pueden visualizar mediante una de varias vistas distintas. 
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TreeView. Muestra una colección jerárquica de elementos con etiquetas. Se 
trata de una estructura en árbol en la que cada nodo del mismo es un objeto de la 
clase TreeNode. 


TabControl. Es un contenedor que agrupa un conjunto relacionado de páginas 
de fichas. 


DateTimePicker. Control que permite seleccionar la fecha y hora. 
MonthCalendar. Control de calendario mensual. 


HScrollBar y VScrollBar. La barra de desplazamiento horizontal y la barra 
de desplazamiento vertical permiten seleccionar un valor dentro de un rango de 
valores. Estos controles son utilizados independientemente de otros objetos, y no 
son lo mismo que las barras de desplazamiento de una ventana. 


Timer. El temporizador permite activar procesos a intervalos regulares de 
tiempo. 


Otros controles de interés son la barra de progreso (ProgressBar), la caja de 
texto enriquecido (RichTextBox), las descripciones breves (ToolTip), la barra de 
estado (StatusStrip), las cajas de diálogo estándar (OpenFileDialog, FontDialog, 
PrintDialog...), etc. 


Siguiendo con nuestra aplicación, seleccionamos de la caja de herramientas 
que acabamos de describir los controles que vamos a utilizar. En primer lugar 
vamos a añadir al formulario una etiqueta. Para ello, hacemos clic sobre la herra- 
mienta Label (etiqueta) y, sin soltar el botón del ratón, la arrastramos sobre el 
formulario. Cuando soltemos el botón del ratón aparecerá una etiqueta de un ta- 
maño predefinido, según se muestra en la figura siguiente: 





ñ 


ay Formi a" 
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Observe en la página de propiedades del entorno de desarrollo, mostrada en la 
figura siguiente, las propiedades (Name), nombre, y AutoSize, autoajustable. La 
primera tiene asignado el valor label] que es el nombre por defecto dado al con- 
trol etiqueta, y la segunda tiene asignado por defecto el valor true, lo que hace 
que el tamaño de la etiqueta se ajuste automáticamente a su contenido. Si quiere 
ajustar su tamaño manualmente, debe asignar a esta propiedad el valor false. 


El nombre de un control se utiliza para referirnos a dicho control en el código 
de la aplicación. 


Propiedades z OX 
i Lista desplegable de los 
, , labell System.Windows.Forms.Label objetos de un formulario, 
Lista de las propiedades  *=[m, 0/1g incluido este. 
del objeto seleccionado. 
Una propiedad se modifi- 




















—— (Name) labell “a 
AccessibleDescripti 


ca in situ. 
AccessibleName 
AccessibleRole Default 
AllowDrop False 
Anchor Top, Left 
AutoEllipsis False 
AutoSize True 
BackColor E] Control v 
Text 


Texto asociado al control. 


Para practicar un poco más, ponga la propiedad AutoSize a valor false. Des- 
pués ajuste su tamaño y céntrela horizontalmente. Para realizar esta última opera- 
ción puede ejecutar la orden Formato > Centrar en el formulario > 
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Ahora se observa sobre la etiqueta un rectángulo con unos cuadrados distri- 
buidos a lo largo de su perímetro, que reciben el nombre de modificadores de ta- 
maño, indicando que se puede modificar el tamaño del control que estamos 
dibujando. Para modificar el tamaño de un control, primero selecciónelo haciendo 
clic sobre él, después apunte con el ratón a alguno de los lados del rectángulo que 
lo envuelve, observe que aparece una doble flecha, y, entonces, con el botón iz- 
quierdo del ratón pulsado, arrastre en el sentido que desee ajustar el tamaño. 


También puede mover el control a un lugar deseado dentro del formulario. 
Para mover un control, primero selecciónelo haciendo clic sobre él y después 
apunte con el ratón a alguna zona perteneciente al mismo y, con el botón izquier- 
do del ratón pulsado, arrastre hasta situarlo en el lugar deseado. 


Borrar un control 


Para borrar un control, primero se selecciona haciendo clic sobre él y, a continua- 
ción, se pulsa la tecla Supr (Del). Para borrar dos o más controles, primero se se- 
leccionan haciendo clic sobre cada uno de ellos, al mismo tiempo que se mantiene 
pulsada la tecla Ctrl, y después se pulsa Supr. 


Se pueden seleccionar también dos o más controles contiguos, pulsando el bo- 
tón izquierdo y arrastrando el ratón hasta rodearlos. 


Propiedades de los objetos 


Cada clase de objeto tiene predefinido un conjunto de propiedades, como nombre, 
tamaño, color, etc. Las propiedades de un objeto representan todos los atributos 
que por definición están asociados con ese objeto. 


Algunas propiedades las tienen varios objetos y otras son únicas para un obje- 
to determinado. Por ejemplo, la propiedad TabIndex (orden Tab) la tienen mu- 
chos objetos, pero la propiedad Interval solo la tiene el temporizador. Cuando se 
selecciona más de un objeto, la página de propiedades visualiza las propiedades 
comunes a esos objetos. 


Cada propiedad de un objeto tiene un valor por defecto que puede ser modifi- 
cado in situ si se desea. Por ejemplo, la propiedad (Name) del formulario del 
ejemplo que nos ocupa tiene el valor Form. 


Para cambiar el valor de una propiedad de un objeto, siga los pasos indicados 
a continuación: 
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1. Seleccione el objeto. Para ello, haga clic sobre el objeto o pulse sucesivamen- 
te la tecla Tab hasta que esté seleccionado (el control seleccionado aparecerá 
rodeado por un rectángulo modificador de tamaño). 


2. Seleccione en la lista de propiedades la propiedad que desea cambiar. 


3. Modifique el valor que actualmente tiene la propiedad seleccionada. El valor 
actual de la propiedad en cuestión aparece escrito a continuación del nombre 
de la misma. Para cambiar este valor, sobrescriba el valor actual o, si es posi- 
ble, seleccione uno de la lista que se despliega haciendo clic sobre la flecha 
(=) que aparece a la derecha del valor actual. Para algunas propiedades, esta 
flecha es sustituida por tres puntos (--). En este caso se visualizará una caja de 
diálogo. 


Se puede también modificar una propiedad durante la ejecución de la aplica- 
ción. Esto implica añadir el código necesario en el método que deba realizar la 
modificación. 


Para verificar el valor de una misma propiedad en varios objetos, se seleccio- 
na esta en la página de propiedades para uno de ellos, y a continuación se pasa de 
un objeto al siguiente haciendo clic con el ratón sobre cada uno de ellos, o sim- 
plemente pulsando la tecla Tab. 


Siguiendo con nuestro ejemplo, vamos a cambiar el título Form1 del formula- 
rio por el título Saludo. Para ello, seleccione el formulario y a continuación la 
propiedad Text en la página de propiedades. Después, sobrescriba el texto 
“Form1” con el texto “Saludo”. 


Veamos ahora las propiedades de la etiqueta. Seleccione la etiqueta y observe 
la lista de propiedades. Algunas de estas propiedades son BackColor (color del 
fondo de la etiqueta), (Name) (identificador de la etiqueta para referirnos a ella en 
el código) y Text (contenido de la etiqueta). Siguiendo los pasos descritos ante- 
riormente, cambie el valor actual de la propiedad (Name) al valor etSaludo, el va- 
lor label! de la propiedad Text a “etiqueta” y alinee este texto para que se 
muestre centrado tanto horizontal como verticalmente; esto requiere asignar a la 
propiedad TextAlign el valor MiddleCenter. A continuación, vamos a modificar 
el tipo de la letra de la etiqueta. Para ello, seleccione la propiedad Font en la pá- 
gina de propiedades, pulse el botón situado a la derecha del valor actual de la pro- 
piedad y elija como tamaño, por ejemplo, 14; las otras características las dejamos 
como están. 


El paso siguiente será añadir un botón. Para ello, hacemos clic sobre la he- 
rramienta Button de la caja de herramientas y arrastramos el botón sobre el formu- 
lario. Movemos el botón y ajustamos su tamaño para conseguir el diseño que 


CAPÍTULO 2: MI PRIMERA APLICACIÓN 29 


observamos en la figura siguiente. Ahora modificamos sus propiedades y asigna- 
mos a Text (título) el valor Haga clic aquí, y a (Name), el valor btSaludo. 





al Saludo a-l- 


etiqueta 


Lo 








También observamos que al colocar el control aparecen unas líneas indicando 
la alineación de este con respecto a otros controles. Es una ayuda para alinear los 
controles que coloquemos dentro del formulario. Puede elegir entre los modos 
SnapLines (líneas de ayuda), es el modo que estamos utilizando, o SnapToGrid 
(rejilla de ayuda; se visualizan los puntos que dibujan la rejilla). Para elegir el 
modo de ayuda, ejecute Herramientas > Opciones, seleccione la opción Diseña- 
dor de Windows Forms y asigne a la propiedad LayoutMode el modo deseado. 
Para que las opciones elegidas tengan efecto, tiene que cerrar el diseñador y vol- 
verlo a abrir. 


Bloquear la posición de todos los controles 


Una vez que haya ajustado el tamaño de los objetos y haya situado los controles 
en su posición definitiva, puede seleccionar el formulario y bloquear sus controles 
para que no puedan ser movidos accidentalmente. Para ello, ejecute la orden Blo- 
quear controles del menú Formato. Para desbloquearlos, proceda de la misma 
forma. 


Icono de la aplicación 


Todos los formularios visualizan un icono en la esquina superior izquierda que 
generalmente ilustra la finalidad de la aplicación y que también aparece cuando se 
minimiza el formulario. Por omisión, Visual C# utiliza un icono genérico. 


Para utilizar su propio icono (de 16 x 16 o de 32 x 32 píxeles), solo tiene que 
asignarlo a la propiedad Icon del formulario; esto es, seleccione el formulario, 
vaya a la página de propiedades, elija la propiedad Icon, pulse el botón que se 
muestra a la derecha y asigne el fichero .¿co que contiene el icono. 
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Escribir los controladores de eventos 


Sabemos que el nombre de un objeto, propiedad (Name), nos permite referirnos a 
él dentro del código de la aplicación; por ejemplo, en las líneas de código siguien- 
te, la primera asigna el valor “¡¡¡Hola mundo!!!” a la propiedad Text del objeto 
etSaludo y la siguiente obtiene el valor de la caja de texto y lo almacena en la va- 
riable sTexto: 


etSaludo.Text = "iiiHola mundo!!!"; 
string sTexto etSaludo.Text; 


En C# la forma general de referirse a una propiedad de un determinado objeto 
es: 


Objeto.Propiedad 


donde Objeto es el nombre del formulario o control y Propiedad es el nombre de 
la propiedad del objeto cuyo valor queremos asignar u obtener. 


Una vez que hemos creado la interfaz o medio de comunicación entre la apli- 
cación y el usuario, tenemos que escribir los métodos para controlar, de cada uno 
de los objetos, aquellos eventos que necesitemos manipular. 


Hemos dicho que una aplicación en Windows es conducida por eventos y 
orientada a objetos. Esto es, cuando sobre un objeto ocurre un suceso (por ejem- 
plo, el usuario hizo clic sobre un botón) se produce un evento (por ejemplo, el 
evento Click); si nosotros deseamos que nuestra aplicación responda a ese evento, 
tendremos que escribir un método que incluya el código que debe ejecutarse 
cuando se produzca y vincularlo con ese evento. El método pertenecerá al objeto 
padre, el formulario en este caso; se dice entonces que el formulario se suscribe al 
evento para que la aplicación realice la operación programada cuando se produzca 
dicho evento. Este método recibe también el nombre de “controlador de eventos”. 


¿Dónde podemos ver la lista de los eventos que puede generar un objeto de 
nuestra aplicación? En la ventana de propiedades. 


Por ejemplo, seleccione el botón btSaludo en la ventana de diseño, vaya a la 
ventana de propiedades y muestre la lista de eventos para el control seleccionado, 
haciendo clic en el botón Eventos. Haga doble clic en el evento Click, o bien es- 
criba manualmente el nombre del controlador y pulse Entrar. 
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El resultado es que se añade a la clase Form1 un controlador para este evento 
(fichero Forml.Designer.cs) y el método btSaludo Click que responderá al mis- 
mo (fichero Form1.cs): 


this .btSaludo.CTick += new System.EventHandler(tnis.btSaludo_CTick) ; 


private void btSaludo_Click(object sender, EventArgs e) 
( 


// Escriba aquí el código que tiene que ejecutarse para responder 
// al evento Click que se genera al pulsar el botón 
) 


La interpretación del código anterior es la siguiente: el método btSaludo_Click 
controla (EventHandler) el evento Click de btSaludo (btSaludo.C11ck). 


El primer parámetro del método hace referencia al objeto que generó el even- 
to y el segundo contiene información que depende del evento. 


Una vez añadido el controlador para el evento Click del botón btSaludo, 
¿cómo lo completamos? Lo que deseábamos era que la etiqueta mostrara el men- 
saje “¡¡¡Hola mundo!!!” cuando el usuario hiciera clic en el botón. Según esto, 
complete este controlador así: 


private void btSaludo_Click(object sender, EventArgs e) 
( 

etSaludo.Text = "iiiHola mundo!!!"; 
) 
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Para añadir el controlador anterior, también podríamos habernos dirigido a la 
página de diseño y haber hecho doble clic sobre el botón de pulsación. 


Un detalle de estilo a la hora de escribir el código. Observe que Visual Studio, 
para no anteponer a los nombres de las clases y otras estructuras de datos el nom- 
bre del espacio de nombres al que pertenecen (por ejemplo System.Object en lu- 
gar de escribir solamente el nombre de la clase Object), añade al principio del 
código fuente las sentencias using, que se muestran a continuación, que los espe- 
cifican. 


using System; 

using System.Collections.Generic; 
using System.ComponentModel'; 
using System.Data; 

using System.Drawing; 

using System.Text; 

using System.Windows.Forms; 


Análogamente a como las carpetas o directorios ayudan a organizar los fiche- 
ros en un disco duro, los espacios de nombres ayudan a organizar las clases en 
grupos para facilitar el acceso a las mismas y proporcionan una forma de crear ti- 
pos globales únicos, evitando conflictos en el caso de clases de igual nombre pero 
de distintos fabricantes, ya que se diferenciarán en su espacio de nombres. 


Además del evento Click, hay otros eventos asociados con un botón de pulsa- 
ción, según se puede observar en la figura anterior. 


Guardar la aplicación 


Una vez finalizada la aplicación, se debe guardar en el disco para que pueda tener 
continuidad; por ejemplo, por si más tarde se quiere modificar. Esta operación 
puede ser que se realice automáticamente cuando se compila o se ejecuta la apli- 
cación, y si no, puede requerir guardar la aplicación en cualquier instante ejecu- 
tando la orden Guardar todo del menú Archivo. 


Si desplegamos el menú Archivo, nos encontraremos, además de con la orden 
Guardar todo, con dos órdenes más: Guardar nombre-fichero y Guardar nombre- 
fichero como... La orden Guardar nombre-fichero guarda en el disco el fichero 
actualmente seleccionado y la orden Guardar nombre-fichero como... realiza la 
misma operación, y además nos permite cambiar el nombre, lo cual es útil cuando 
el fichero ya existe. 


No es conveniente que utilice los nombres que Visual C# asigna por defecto, 
porque pueden ser fácilmente sobrescritos al guardar aplicaciones posteriores. 
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Verificar la aplicación 


Para ver cómo se ejecuta la aplicación y los resultados que produce, hay que se- 
leccionar la orden /niciar sin depurar del menú Depurar o pulsar Ctrl+F5, 


Si durante la ejecución encuentra problemas o la solución no es satisfactoria y 
no es capaz de solucionarlos por sus propios medios, puede utilizar, fundamen- 
talmente, las órdenes Paso a paso por instrucciones (F11), Paso a paso por pro- 
cedimientos (F10) y Alternar puntos de interrupción (F9), todas ellas del menú 
Depurar, para hacer un seguimiento paso a paso de la aplicación, y las órdenes 
del menú Depurar > Ventanas, para observar los valores que van tomando las va- 
riables y expresiones de la aplicación. 


La orden Paso a paso por instrucciones permite ejecutar cada método de la 
aplicación paso a paso. Esta modalidad se activa y se continúa pulsando F71. Si 
no quiere que los métodos invocados a su vez por el método en ejecución se eje- 
cuten línea a línea, sino de una sola vez, utilice la tecla F70 (Paso a paso por pro- 
cedimientos). Para detener la depuración pulse las teclas Mayús+F3. 


La orden Alternar puntos de interrupción (F9) permite colocar una pausa en 
cualquier línea. Esto permite ejecutar la aplicación hasta la pausa en un solo paso 
(F5), y ver en la ventana Automático los valores que tienen las variables en ese 
instante. Para poner o quitar una pausa, se coloca el cursor donde se desea que 
tenga lugar dicha pausa y se pulsa F9, o bien se hace clic con el ratón sobre la ba- 
rra situada a la izquierda del código. 


Forml.cs Forml1.cs [Diseño] X 

*%, Saludo.Form1 ~ O, InitializeComponent( X 

29 E private void InitializeComponent() + 

30 { a 

31 this.etSaludo = new System.Windows.Forms.Label(); 

32 this.btSaludo = new System. Windows .Forms.Button(); 

33 this.SuspendLayout(); 

34 1 

35 // etSaludo 

36 1! 

37 this.etSaludo.Font = new System.Drawing.Font("Microsoft Sans Serif", 13.74545F, System.Drawi 

38 this.etSaludo.Location = new System.Drawing.Point(36, 50); 

39 this.etSaludo.Name = "etSaludo”; 

40 this.etSaludo.Size = new System.Drawing.Size(221, 30); 

41 this.etSaludo.TablIr[-] # this.e + 
o ~% this.etSaludo.Text = # Height 30 = 

43 this.etSaludo.TextAli  £ IsEmpty ` false lignment.MiddleCenter; 

44 1! # Width 221 

45 // btSaludo [4] % Miembros estáticos 

46 S E] Miembros no públicos 

47 this.btSaludo.Locatior-=- new- >ystem.orawing.rvint(36, 116); 

48 this.btSaludo.Name = "btSaludo”; 

49 this.btSaludo.Size = new System.Drawing. Size(221, 30); 

59 this.btSaludo.TabIndex = 1; 

51 this.btSaludo.Text = "Haga clic aquí"; 

52 this.btSaludo.UseVisualStyleBackColor = true; 

53 this.btSaludo.Click += new System. EventHandler(this.btSaludo_Click); 

54 1! a 


100% v~ 4 b 
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La línea de código señalada con una flecha (puntero de ejecución) es la si- 
guiente sentencia a ejecutar. Alternativamente al menú de depuración, puede utili- 
zar la barra de herramientas de depuración. 


También puede utilizar el ratón para arrastrar el puntero de ejecución (observe 
la flecha en el margen izquierdo de la ventana anterior) a otro lugar dentro del 
mismo método con la intención de alterar el flujo normal de ejecución. 


Durante el proceso de depuración, puede ver en la ventana Automático los va- 
lores de las variables y expresiones que desee. Además, en la ventana Inspección 
puede escribir la expresión que desea ver. 


Automático Y Ax 
Nombre Valor Tipo 
$ System.Drawing.ContentAligr MiddleCenter System 
E] e this (Saludo.Form1, Text: } Saludo. 
[+] 6 this.etSaludo (System.Windows.Forms.Label, Text: etiqueta) System 
# this.etSaludo.TextAlign TopLeft System 


También, puede seleccionar en la ventana de código la expresión cuyo valor 
quiere inspeccionar y ejecutar Inspección rápida... Una forma más rápida de hacer 
esto último es situando el puntero del ratón sobre la expresión; le aparecerá una 
etiqueta con el valor, como se puede observar en la ventana de código anterior. 


Así mismo, según se observa en la figura siguiente, puede ejecutar en la Ven- 
tana Inmediato cualquier sentencia de una forma inmediata. Para mostrar u ocul- 
tar esta ventana ejecute la orden Ventanas > Inmediato del menú Debug. El 
resultado del ejemplo mostrado es el contenido de la propiedad Text de la etiqueta 
etSaludo (observe el uso del símbolo ?). 


Ventana Inmediato TRK 
? etSaludo.Text a 
"etiqueta" 


Una vez iniciada la ejecución de la aplicación, si se pulsa la tecla F5, la eje- 
cución continúa desde la última sentencia ejecutada en un método hasta finalizar 
ese método o hasta otro punto de parada. 
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Propiedades del proyecto 


Para establecer las propiedades del proyecto actual hay que ejecutar la orden Pro- 
yecto > Propiedades de nombre-proyecto... Se le mostrará una ventana con varios 
paneles. Seleccione el deseado y modifique las propiedades que considere. 























Forml.cs Forml.cs [Diseño] a 
Compilar 
Eventos de compilación Nombre del ensamblado: Espacio de nombres predeterminado: ž 
ro Saludo 
Recursos Versión de .NET Framework de destino: Tipo de resultado: 
Servicios (¡ner Framework 4.5 Zi | [Aplicación para Windows z | 
Configuración : ES 
Objeto de inicio: 
Rutas de acceso de referencia ] 
(Sin establecer) ği Información de ensamblado... ) 
Firma 
Seguridad Recursos 
Publicar Especifique cómo se administrarán los recursos de la aplicación: F 


Análisis de código 
(9) Icono y manifiesto 
Los manifiestos determinan la configuración específica de una aplicación. Para incrustar un manifiesto personalizado, 
primero agréguelo al proyecto y después selecciónelo de la lista incluida a continuación. 


Icono: 


(Icono predeterminado) e] E 


Manifiesto: 





Incrustar manifiesto con configuración predeterminada ” 


Archivo de recursos: 


Crear soluciones de varios proyectos 


Una solución agrupa uno o más proyectos. Por omisión, cuando se crea un nuevo 
proyecto, en la misma carpeta física se crea la solución (fichero con extensión 
.sIn) a la que pertenece, con el mismo nombre que el proyecto. Esta solución per- 
mite que los ficheros que forman parte del proyecto se almacenen bajo una estruc- 
tura de directorios que facilite su posterior localización así como las tareas de 
compartir la solución con otros desarrolladores de un posible equipo. 


¿Qué tenemos que hacer si necesitamos agrupar varios proyectos bajo una 
misma solución? Crear una solución vacía y añadir nuevos proyectos a la solu- 
ción, o añadir nuevos proyectos a la solución existente. Asegúrese de que se va a 
mostrar siempre el nombre de la solución en el explorador de soluciones. Para 
ello, ejecute Herramientas > Opciones > Proyectos y soluciones > Mostrar siem- 
pre la solución. 


Para crear una nueva solución vacía: 


1. Ejecute la orden Archivos > Nuevo > Proyecto. 
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2. Como tipo de proyecto, seleccione Otros tipos de proyectos. 
3. Y como plantilla, seleccione Solución en blanco. 


4. Finalmente, introduzca el nombre que desea dar a la solución. Se creará un fi- 
chero .s/n con el nombre dado, almacenado en una carpeta con el mismo 
nombre. Puede elegir, si lo desea, la posición que ocupará esa carpeta en el 
sistema de ficheros de su plataforma. 


Para añadir un nuevo proyecto a una solución existente: 


1. Diríjase al explorador de soluciones y haga clic sobre el nombre de la solu- 
ción utilizando el botón secundario del ratón. Del menú contextual que se vi- 
sualiza, ejecute la orden Añadir > Nuevo proyecto... 


2. Seleccione el tipo de proyecto y la plantilla que va a utilizar para crearlo. 
3. Para añadir nuevos proyectos repita los pasos anteriores. 


4. Para activar el proyecto sobre el que va a trabajar, haga clic sobre el nombre 
del proyecto utilizando el botón secundario del ratón y del menú contextual 
que se visualiza, ejecute la orden Establecer como proyecto de inicio. 


Opciones del EDI 


Para mostrar la ventana que observa en la figura siguiente tiene que ejecutar la or- 
den Herramientas > Opciones... Desde esta ventana podrá establecer opciones pa- 
ra el entorno de desarrollo, para los proyectos y soluciones, para el diseñador, 
para el depurador, etc. Por ejemplo, para que el depurador solo navegue a través 
del código escrito por el usuario, no sobre el código añadido por los asistentes, 
tiene que estar activada la opción “habilitar solo mi código”; Herramientas > Op- 
ciones > Depuración > General > Habilitar solo mi código. 
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Opciones Do 

b Entorno = 4 Configuración de diseño 
b Proyectos y soluciones Ajustar a la cuadrícula True 
b Control de código fuente Modo de diseño SnapLines zi 
b Editor de texto Mostrar cuadrícula True 
b Depuración b Tamaño de celda de cuadrícula predetern 8; 8 
ò IntelliTrace 4 Configuración de la generación de código 
> Herramientas de rendimiento Generación de código optimizada True 
b Administrador de paquetes 4 Configuraciones de etiquetas inteligentes enlazadas a objetos 
> Diseñador de flujo de trabajo z Abrir automáticamente etiquetas intelige True 
4 Diseñador de Windows Forms 4 Cuadro de herramientas 

General Rellenar automáticamente caja de herrarr True 

Personalización de IU de datos 4 Refactorización 
> Diseñador HTML Habilitar refactorización en cambios de n: True 
> Herramientas de F# 
b Herramientas de Office 
b Herramientas de SQL Server | 
> Herramientas para bases de datos | Modo de diseño 
b Herramientas para pruebas de rendir Alterna el modo de diseño del diseñador. Los cambios en esta propiedad se verán cuando... 
O 3 , B 

x "i 





Personalizar el EDI 


Para personalizar el entorno de desarrollo tiene que ejecutar la orden Herramien- 
tas > Personalizar... Desde esta ventana podrá añadir o quitar elementos de un 
menú, añadir o quitar una barra de herramientas, añadir o quitar un botón de una 
barra de herramientas, etc. 
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F 
Personalizar (0 kes 


| Barras de herramientas | Comandos | 
























































Elija la barra de menús o de herramientas que desea 
(9) Barra de menús: | Depurar x 
Barra de herramientas: | Bordes del informe 
J Menú contextual: TFS 
Controles: 
Ventanas > ES Agregar comando... 
Gráficos » j£ 7 
Agregar nuevo menú 
> Iniciar o continuar Eliminar 
Ð Iniciar sin depurar = 
y Subir 
II interrumpir todos 
M Detener depuración Bajar 
ES Inidar análisis de rendimiento 7 z 
E O 3A Modificar selección Y 
EN Iniciar análisis de rendimiento en pausa 5 
Detener análisis de rendimiento ~ Restablecer todo 























Teclado... | 

















WPF 


Una alternativa a la biblioteca Windows Forms para diseñar aplicaciones que uti- 
licen interfaces gráficas es la biblioteca de clases denominada WPF (Windows 
Presentation Foundation - clases base de .NET para el desarrollo de interfaces 
gráficas de usuario vectoriales avanzadas definidas en su mayoría en el espacio de 
nombres System. Windows). 


WPF no ha sido creado para sustituir a Windows Forms, sino que la biblioteca 
Windows Forms seguirá siendo mejorada y mantenida por Microsoft. WPF es 
simplemente otra biblioteca con otras posibilidades para el desarrollo de aplica- 
ciones de escritorio. Por ejemplo, facilita el desarrollo de aplicaciones en el que 
estén implicados diversos tipos de medios: vídeo, documentos, contenido 3D, se- 
cuencias de imágenes animadas, o una combinación de cualquiera de los anterio- 
res. WPF también es idóneo si lo que se necesita es crear una interfaz de usuario 
con un aspecto personalizado (skins), si hay que establecer vínculos con datos 
XML, o si hay que cargar dinámicamente porciones de una interfaz de usuario 
desde un servicio web, o se desea crear una aplicación de escritorio con un estilo 
de navegación similar a una aplicación web. Además, y a diferencia de Windows 
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Forms, proporciona la capacidad para programar una aplicación utilizando el len- 
guaje de marcado XAML para implementar su interfaz gráfica y los lenguajes de 
programación administrados, como C#, para escribir el código subyacente que 
implemente su comportamiento. Esta separación entre la apariencia y el compor- 
tamiento permite a los diseñadores implementar la apariencia de una aplicación al 
mismo tiempo que los programadores implementan su comportamiento. 


¿WPF o Windows Forms? Windows Forms todavía tiene un papel importante 
que desempeñar, a pesar de que WPF haya entrado en escena. Si estamos constru- 
yendo aplicaciones que no necesitan de la amplia y moderna funcionalidad de 
WPF, entonces no hay razón de peso para cambiar y dejar atrás toda una expe- 
riencia adquirida. Además, actualmente, Windows Forms acumula mucha más ex- 
periencia en Visual Studio que WPF, razón de peso para no olvidarnos de esta 
biblioteca y seguir utilizándola cuando nos proporcione lo que necesitamos. 


No obstante, esta biblioteca no entra dentro de los objetivos de este libro y 
además, por su extensión, el autor lo ha tratado en un libro aparte titulado Visual 
CH - Interfaces gráficas y aplicaciones para Internet con WPF, WCF y Silver- 
light. 


PARTE 











Interfaces gráficas 


Aplicación Windows Forms 
Introducción a Windows Forms 
Menús y barras de herramientas 
Controles y cajas de diálogo 
Tablas y árboles 

Dibujar y pintar 

Interfaz para múltiples documentos 
Construcción de controles 


Programación con hilos 


CAPÍTULO 3 


O F.J.Ceballos/RA-MA 


APLICACIÓN WINDOWS FORMS 


Una de las grandes ventajas de trabajar con Windows es que todas las ventanas se 
comportan de la misma forma y todas las aplicaciones utilizan los mismos méto- 
dos básicos (menús desplegables, botones) para introducir órdenes. 


Una ventana típica de Windows tiene las siguientes partes: 
1. Barra de menús. Visualiza el conjunto de los menús disponibles para esa apli- 
cación. Cuando se activa alguno de los menús haciendo clic con el ratón sobre 


su título, se visualiza el conjunto de órdenes que lo forman. 


2 3 4 5 










r 


‘| Sin título: Bloc de notas 





Archivo Edición Formato Ver Ayuda 














10 9 8 
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2. Icono de la aplicación y menú de control. El menú de control proporciona ór- 
denes para restaurar su tamaño, mover, tamaño, minimizar, maximizar y ce- 
rrar la ventana. 


3. Barra de título. Contiene el nombre de la ventana y del documento. Para mo- 
ver la ventana a otro lugar, apunte con el ratón a esta barra, haga clic utilizan- 
do el botón izquierdo del ratón y, manteniendo pulsado el botón, arrastre en la 
dirección deseada. Un doble clic maximiza o retorna a tamaño normal la ven- 
tana, dependiendo de su estado actual. 


4. Botón para minimizar la ventana. Cuando se pulsa este botón, la ventana se 
reduce a su forma mínima. Esta es la mejor forma de mantener las aplicacio- 
nes cuando tenemos varias de ellas activadas y no se están utilizando en ese 
instante. 


5. Botón para maximizar la ventana. Cuando se pulsa este botón, la ventana se 
amplía al máximo y el botón se transforma en El. Si este se pulsa, la ventana 
se reduce al tamaño anterior. 


6. Botón para cerrar la ventana. Cuando se pulsa este botón, se cierra la ventana 
y la aplicación si la ventana es la principal. 


7. Barra de desplazamiento vertical. Cuando la información no entra vertical- 
mente en una ventana, Windows añade una barra de desplazamiento vertical a 
la derecha de la ventana. 


8. Marco de la ventana. Permite modificar el tamaño de la ventana. Para cam- 
biar el tamaño, apunte con el ratón a la esquina o a un lado del marco, y cuan- 
do el puntero cambie a una flecha doble, con el botón izquierdo del ratón pul- 
sado arrastre en el sentido adecuado para conseguir el tamaño deseado. 


9. Barra de desplazamiento horizontal. Cuando la información no entra horizon- 
talmente en una ventana, Windows añade una barra de desplazamiento hori- 
zontal en el fondo de la ventana. 


Cada barra de desplazamiento tiene un cuadrado de desplazamiento que se 
mueve a lo largo de la barra para indicar en qué posición nos encontramos con 
respecto al principio y al final de la información tratada, y dos flechas de des- 
plazamiento. 


Para desplazarse: 


e Una línea verticalmente o un carácter horizontalmente, utilice las flechas 
de desplazamiento de las barras. 
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e Varias líneas verticalmente o varios caracteres horizontalmente, apunte 
con el ratón a una flecha de desplazamiento, haga clic con el botón iz- 
quierdo y mantenga el botón pulsado. 


e Aproximadamente una pantalla completa, haga clic sobre la barra de des- 
plazamiento. Para subir, haga clic por encima del cuadrado de desplaza- 
miento de la barra vertical, y para bajar, haga clic por debajo del cuadra- 
do. Para moverse a la izquierda, haga clic a la izquierda del cuadrado de 
desplazamiento de la barra horizontal, y para moverse a la derecha, haga 
clic a la derecha del cuadrado. 


e A un lugar específico, haga clic sobre el cuadrado de desplazamiento y, 
manteniendo el botón del ratón pulsado, arrastre el cuadrado. 


10. Área de trabajo. Es la parte de la ventana en la que el usuario coloca el texto 
y los gráficos. 


Un objeto en general puede ser movido a otro lugar haciendo clic sobre él y 
arrastrándolo manteniendo pulsado el botón izquierdo del ratón. 


PROGRAMANDO EN WINDOWS 


Una aplicación para Windows diseñada para interaccionar con el usuario presen- 
tará una interfaz gráfica que mostrará todas las opciones que el usuario puede rea- 
lizar. Dicha interfaz se basa fundamentalmente en dos tipos de objetos: ventanas 
(también llamadas “formularios”) y controles (botones, cajas de texto, menús, lis- 
tas, etc.); esto es, utilizando estos objetos podemos diseñar dicha interfaz, pero pa- 
ra que proporcione la funcionalidad para la que ha sido diseñada, es necesario 
añadir el código adecuado. En resumen, para realizar una aplicación que muestre 
una interfaz gráfica, se crean objetos que den lugar a ventanas y sobre esas venta- 
nas se dibujan otros objetos llamados “controles”; finalmente se escribe el código 
fuente relacionado con la función que tiene que realizar cada objeto de la interfaz. 
Esto es, cada objeto estará ligado a un código que permanecerá inactivo hasta que 
se produzca el evento que lo active. Por ejemplo, podemos programar un botón 
(objeto que se puede pulsar) para que al hacer clic sobre él con el ratón muestre 
un formulario solicitando unos determinados datos. 


Según lo expuesto, una aplicación en Windows presenta todas las opciones 
posibles en uno o más formularios para que el usuario elija una de ellas. Por 
ejemplo, en la figura siguiente, cuando el usuario haga clic sobre el botón Haga 
clic aquí, en la caja de texto aparecerá el mensaje ¡¡¡Hola mundo!!! Se dice en- 
tonces que la programación es conducida por eventos y orientada a objetos. 
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¡¡¡Hola mundo!!! 





Haga clic aquí 

















Cuando desarrollamos una aplicación de este estilo, la secuencia en la que se 
ejecutarán las sentencias no puede ser prevista por el programador. Por ejemplo, 
si en lugar de un botón hubiera dos o más botones, claramente se ve que el pro- 
gramador no puede escribir el programa pensando que el usuario va a pulsarlos en 
una determinada secuencia. 


Por lo tanto, para programar una aplicación Windows hay que escribir código 
separado para cada objeto en general, quedando la aplicación dividida en peque- 
ños procedimientos o métodos conducidos por eventos. Por ejemplo: 


btSaludo.Click += new System.EventHandler(btSaludo_Click); 


private void btSaludo_Click(object sender, EventArgs e) 
( 

etSaludo.Text = "¡¡iHola mundo!!!"; 
) 


El método biSaludo Click será puesto en ejecución en respuesta al evento 
Click del objeto identificado por btSaludo (botón titulado “Haga clic aquí”). 
Quiere esto decir que cuando el usuario haga clic en el objeto btSaludo se ejecuta- 
rá el método biSaludo_ Click. Esto es justamente lo que está indicando el delegado 
EventHandler (los delegados serán explicados en el capítulo titulado Programa- 
ción con hilos), código que fue añadido por el diseñador en el fichero 
Forml.Designer.cs cuando el formulario Form] se suscribió al evento Click de 
btSaludo; el método btSaludo Click al que hace referencia el delegado fue añadi- 
do también por el diseñador en el fichero Form1.cs. Por ello, esta forma de pro- 
gramar se denomina “programación conducida por eventos y orientada a objetos”. 


Los eventos son mecanismos mediante los cuales los objetos (ventanas o con- 
troles) pueden notificar de la ocurrencia de sucesos. Un evento puede ser causado 
por una acción del usuario (por ejemplo, cuando pulsa una tecla), por el sistema 
(transcurrido un determinado tiempo) o indirectamente por el código (al cargar 
una ventana). En Windows, cada ventana y cada control pueden responder a un 
conjunto de eventos predefinidos. Cuando ocurre uno de estos eventos, Windows 
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lo transforma en un mensaje que coloca en la cola de mensajes de la aplicación 
implicada. Un método Run, denominado bucle de mensajes, es el encargado de 
extraer los mensajes de la cola y despacharlos para que sean procesados. Eviden- 
temente, cada mensaje almacenará la información suficiente para identificar al ob- 
jeto y ejecutar el método que tiene para responder a ese evento. En la figura si- 
guiente puede ver de forma gráfica cómo actúa el bucle de mensajes mientras la 


aplicación está en ejecución: 
Método 
étodo 
Método 2 












Recuperar Entregar 






siguiente información 
mensaje del mensaje Método 3 
2 Método 4 


Sí 





Como ejemplo, repase la aplicación que acabamos de comentar, la que da lu- 
gar al mensaje “¡¡¡Hola mundo!!!”, que fue implementada en el capítulo 2. 


ESTRUCTURA DE UNA APLICACIÓN 


En el capítulo 2 desarrollamos una aplicación que mostraba una ventana como la 
expuesta anteriormente. En este apartado, vamos a detenernos en esta aplicación 
para analizarla, con el fin de estudiar desde un punto de vista práctico cuáles son y 
cómo interaccionan entre sí los objetos que la configuran. La interfaz gráfica de la 
aplicación aludida se construyó sobre un objeto ventana como el de la figura si- 
guiente: 
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Esta ventana tiene un menú de control, un título y los botones de maximizar, 
minimizar y cerrar. Cuando el usuario pulse el botón =, la ventana se reducirá a 
un icono; cuando pulse el botón W=, la ventana se agrandará para ocupar toda la 
pantalla; y cuando lo haga en E), la ventana se cerrará. Así mismo, cuando haga 
clic encima del icono de la aplicación situado a la izquierda de la barra de título se 
abrirá el menú de control. Este menú incluye las órdenes: Restaurar, Mover, Ta- 
maño, Minimizar, Maximizar y Cerrar. Las tres últimas realizan la misma función 
que los botones descritos. 








Una ventana como la anterior no es más que un objeto de una clase derivada 
de Form. Según esto, el código mostrado a continuación puede ser una estructura 
válida para la mayoría de las aplicaciones que inician su ejecución visualizando 
una ventana principal. Para probarlo, cree un proyecto vacio, especifique en las 
propiedades del proyecto que el tipo de resultado será una aplicación para Win- 
dows y añada un nuevo fichero .cs con el código siguiente: 


using System; 
using System.Windows.Forms; 
using System.Drawing; 


public class Formi : Form 
( 
public Forml() 
( 
IniciarComponentes(); 
) 


public void IniciarComponentes() 
( 
ClientSize = new Size(292, 191); 
Name = "Forml"; 
Text = "Saludo"; 





} 


protected override void Dispose(bool eliminar) 
( 
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if (eliminar) 


( 


1 
J 


base.Dispose(eliminar); 
) 


public static void Main() 
( 

Application.Runínew Form1()); 
) 


Analizando el código anterior se puede observar que la ventana a la que nos 
referimos es un objeto de una subclase de la clase Form del espacio de nombres 
System. Windows.Forms. 


El punto de entrada a la aplicación es el método Main. Este método podría 
también haberse escrito en una clase aparte, como ocurría en la aplicación Saludo 
que desarrollamos en el capítulo 2. Veamos qué ocurre cuando se ejecuta este mé- 
todo: 


public static void Main() 
( 


Application.Run(hew Formi()); 
) 


e Primero se invoca al constructor de la clase Form] para construir un objeto de- 
rivado de Form que se corresponde con la ventana principal de la aplicación o 
ventana marco. 


new Forml() 


e FEl constructor llama de forma predeterminada al constructor de su clase base, 
que crea una ventana con un tamaño, un nombre y un título por omisión, y des- 
pués al método IniciarComponentes. 


public Form1() 
( 

IniciarComponentes(); 
) 


e El método /niciarComponentes permite personalizar el tamaño, el nombre y el 
título de la ventana y construir los controles de la misma. 


public void IniciarComponentes() 
( 
// Construir aquí los controles 
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// Iniciar formulario: objeto de la clase Forml 
ClientSize = new Size(292, 191); 
Name = "Forml"; 
Text = "Saludo"; 
) 


En esta primera versión, IniciarComponentes asigna a la propiedad ClientSi- 
ze del objeto Form] un nuevo tamaño dado por un objeto de la clase Sys- 
tem.Drawing.Size (recuerde que el objeto para el cual se invoca un método 
está implícitamente referenciado por this; esto es, ClientSize = new ..., es 
equivalente a this. ClientSize = new ...). Así mismo, asigna a la propiedad 
Name el nombre por el que podremos identificar a ese objeto (por ejemplo, 
en una sentencia if), y a la propiedad Text, el título de la ventana. 


En lugar de ClientSize (área de cliente: región de la ventana donde se colocan 
los controles) podríamos utilizar Size, pero especificando el tamaño de la ven- 
tana. 


e Finalmente, cuando se cierra la ventana (clic en el botón EM), el objeto 
Forml invoca a su método Dispose heredado de Form, método que podemos 
utilizar para liberar los recursos que hayamos asignado en nuestra aplicación. 
Este método recibe un parámetro que cuando es true significa que Dispose ha 
sido llamado directa o indirectamente por el código del usuario, no por el 
CLR. Dispose solo es implementado por los objetos que tienen acceso a re- 
cursos no administrados ya que de los objetos administrados no usados se en- 
carga el recolector de basura. 


protected override void Disposeí(bool eliminar) 
if (eliminar) 
// Liberar recursos 
o 
) 


Obsérvese que en la cabecera de este método aparecen dos modificadores: 
protected y override. Un miembro de una clase declarado protegido (protec- 
ted) es accesible solamente por los métodos de su propia clase y por los de las 
clases derivadas de esta. Y el modificador override indica que este método 
está reemplazando al método virtual heredado de la clase base. 


e Una vez finalizado el método /niciarComponentes, la ventana principal (obje- 
to de la clase Form1) está construida. Para visualizarla e iniciar el bucle de 
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mensajes de la aplicación, el método Main invoca al método Run de la clase 
Application del espacio de nombres System. Windows.Forms. 


public static void Main() 
( 

Application.Run(new Forml()); 
} 


Una vez iniciada la ejecución de la aplicación, esta queda a la espera de las 
acciones que pueda emprender el usuario de la misma. En el ejemplo tan simple 
que acabamos de presentar, una de las acciones que puede tomar el usuario es ce- 
rrar la ventana, lo que origina el evento correspondiente. ¿Cómo responde la apli- 
cación a este evento? Ejecutando el método Dispose y finalizando el bucle de 
mensajes, para lo cual Run invoca al método Application.Exit. El método Exit 
cierra todas las ventanas y fuerza a Run a retornar. Lógicamente, se pueden pro- 
ducir otros eventos; por ejemplo: la ventana se abre, se minimiza, vuelve a su es- 
tado normal, etc. Lo que tiene que saber es que la aplicación siempre responderá a 
cada evento invocando a su método asociado. 


Cuando creamos una aplicación Visual C# con Visual Studio, el código gene- 
rado aporta explícitamente el método Main en una clase Program localizada en el 
fichero Program.cs. No obstante, cuando lo requiera, puede añadir uno personali- 
zado, según muestra el código anterior, indicándolo en las propiedades de la apli- 
cación. La figura siguiente nos muestra lo que hay que hacer para que la aplica- 
ción se inicie desde un método Main en Form]. 

















Apl 
Compilar 
Eventos de compilación Nombre del ensamblado: Espacio de nombres predeterminado: a 
Depurar Saludo Saludo 
Recursos Versión de .NET Framework de destino: Tipo de resultado: E 
Servicios [NeT Framework 4.5 ~| [Aplicación para Windows 
Configuración à z L 
Objeto de inicio: 
Rutas de acceso de referencia > 
d Información de ensa 
Firma (Sin establecer) 
Seguridad 
Publicar Especifique cómo se administrarán los recursos de la aplicación: 


Análisis de código ki 
«| M + 


Compilar y ejecutar la aplicación 


Observe las tres primeras lineas de código de la aplicación anterior, especifican 
los espacios de nombres a los que pertenecen las clases utilizadas por Form1: 


using System; // Clases fundamentales. 
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using System.Windows.Forms; // Clase Form. 
using System.Drawing; // Objetos gráficos. 


Sabemos que la propia biblioteca de clases .NET está organizada en espacios 
de nombres que agrupan esas clases dispuestas según una estructura jerárquica. 
Pues bien, estos espacios de nombres se corresponden con bibliotecas dinámicas 
del mismo nombre, a las que tendremos que hacer referencia cuando se compile 
una aplicación, en la medida en la que sean necesarias; por ejemplo, en mi disco 
están almacenadas en la carpeta CWINDOWSWMicrosoft. NET EFrameworklvXXX. 


Según lo expuesto, para compilar y ejecutar la aplicación desde la línea de ór- 
denes tendremos que realizar los pasos siguientes: 


1. Especificar la ruta, si aún no está especificada, donde se localiza el compila- 
dor de Visual C#. Por ejemplo: 


set path=%path%;C:AWINDOWSAMicrosoft.NETAFrameworkAvXXX 


2. Compilar la aplicación. Si suponemos que está almacenada en c.leslejem- 
plosiCap03|Saludo|Saludo.cs, escribiríamos: 


cd c:\cs\ejemplos\Cap03\Saludo 
csc /r:System.dl1,System.Windows.Forms.dl1,System.Drawing.dl1l Saludo.cs 


Si no necesitamos indicar explícitamente las bibliotecas, podremos escribir: 


csc Saludo.cs 


3. Ejecutar la aplicación. Para nuestro ejemplo, escribiríamos: 
Saludo 





r 





EN C\Windows\system32\cmd.exe =| 





Microsoft Windows [Versión 6.1.7601] 
Copyright (c) 2009 Microsoft Corporation. Reservados todos los derechos. 


la > 


C:JUsersifjceballos>set path=%path%;C:AWindowsYMicrosoft.NETiFrameworkiu4.0.3031 
9 


C:1Usersifjceballos>cd C:1cstejemplosiCap031Saludo 


C:1cstejemplosiCap031Saludo>»csc Saludo.cs 

Compilador de Microsoft (R) Visual CH, versión 4.0.30319.17929 
para Microsoft (R) .NET Framework 4.5 

(C) Microsoft Corporation. Reservados todos los derechos. 


C:1cstejemplos1Cap031Saludo>Saludo 














C:1cestejemplosiCap031Saludo>,, X 
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Desde el entorno de desarrollo Visual Studio, todo este proceso es automáti- 
co, según explicamos en el capítulo 2. Así mismo, será necesario especificar las 
referencias a las bibliotecas en el nodo References si aún no están especificadas: 


Explorador de soluciones a ESS 


M 0-05 A 
Buscar en el Explorador de soluciones ( AP > 
ø] Solución 'Saludo' (1 proyecto) 
4 Saludo 
4 5] References 
sa System 
aa System.Drawing 
sa System.Windows.Forms 
YA app.config 


» Saludo.cs 


Explorador de soluciones Vista de clases 


DISEÑO DE LA INTERFAZ GRÁFICA 


Nuestro siguiente paso consistirá en añadir a la ventana los componentes que tie- 
nen que formar parte de la interfaz gráfica. Este proceso requiere colocar en la 
misma los controles que nosotros creamos adecuados y añadir a la aplicación 
otras ventanas si fuera necesario. 


Crear un componente 


La forma de crear un componente (una ventana o un control) no difiere en nada de 
como lo hacemos con un objeto de cualquier otra clase. Se crea el componente in- 
vocando al constructor de su clase y se inician las propiedades del mismo invo- 
cando a los métodos correspondientes. 


Controles más comunes 


Hay controles para cada uno de los elementos que usted ya ha visto, más de una 
vez, en alguna ventana de la interfaz gráfica de su sistema Windows, UNIX u 
otro. A continuación se muestra de forma resumida una lista de los más comunes: 


e Etiquetas. Se implementan a partir de la clase Label. 
e Botones. Se implementan a partir de la clase Button. 


e Cajas de texto. Se implementan a partir de la clase TextBox las de una sola 
línea de texto, las de varias líneas y las de “palabra de paso”. 


e Casillas de verificación. Se implementan a partir de la clase CheckBox. 
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Botones de opción. Se implementan a partir de la clase RadioButton. 
Listas. Se implementan a partir de las clases ListBox y ComboBox. 


Barras de desplazamiento. Se implementan a partir de la clase ScrollBar. 


Los controles descritos se localizan en el espacio de nombres System.Win- 


dows.Forms y son objetos de subclases de la clase Control que a su vez se deriva 
de la clase System.ComponentModel.Component. 


Añadir una etiqueta y editar sus propiedades 


Para añadir una etiqueta al formulario proporcionado por el objeto Form] siga es- 
tos pasos: 


1. 


Añada a la clase Form1 una variable de tipo Label denominada etSaludo: 
private Label etSaludo; 


Cree un objeto Label referenciado por etSaludo. Para ello, añada al método 
IniciarComponentes el código siguiente: 


etSaludo = new Label(); 


Modifique las propiedades de la etiqueta para asignarle el nombre “etSaludo” 
y para que muestre inicialmente el texto “etiqueta”, centrado, con estilo regu- 
lar y de tamaño 14. Para ello, escriba a continuación de la sentencia anterior 
el siguiente código: 

etSaludo.Name = "etSaludo"'; 

etSaludo.Text = "etiqueta"; 

etSaludo.Font = new Font("Microsoft Sans Serif", 14, 
FontStyle.Regular); 

etSaludo.TextAlign = ContentAlignment.MiddleCenter; 





La propiedad Name ya fue comentada anteriormente. La propiedad Text al- 
macena el texto que mostrará el control. 


La propiedad Font indica el tipo de fuente que utilizará el control para mos- 
trar su texto. 


La propiedad TextAlign indica el tipo de alineación que se aplicará al texto 
respecto a los límites del control; por ejemplo, el miembro MiddleCenter de la 
enumeración ContentAlignment del espacio de nombres System.Drawing 
indica que el texto será centrado vertical y horizontalmente. 


Finalmente, establezca su posición en el contenedor, su tamaño, asígnele 1 
como orden Tab y añádala al formulario. 


10. 


11. 


12. 
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etSaludo.Location = new Point(53, 48); 
etSaludo.Size = new Size(187, 35); 
etSaludo.Tablndex = 1; 
Controls.Add(etSaludo); 


La propiedad Location hace referencia a un objeto de la clase Point que al- 
macena las coordenadas de la esquina superior izquierda del componente. 


La propiedad Size hace referencia a un objeto de la clase Size que almacena 
el tamaño (ancho y alto) del componente. 


La propiedad TabIndex indica el orden Tab de un control. Todos los contro- 
les tienen un orden Tab (0, 1, 2, etc.) por omisión, en función del orden en el 
que hayan sido añadidos al formulario. El control que quedará enfocado (se- 
leccionado) cuando se arranca la aplicación será el de orden Tab 0 y cuando 
se utilice la tecla Tab para cambiar el foco a otro control, se seguirá el orden 
Tab establecido. Solo pueden tener el foco aquellos controles que tienen su 
propiedad TabStop a valor true. 


La propiedad Controls del formulario es un objeto de la clase Control.Con- 
trolCollection y hace referencia a la colección de controles del formulario. Se 
trata de una matriz unidimensional de objetos Control, que es la clase base 
para los controles que aquí estamos explicando. 


El método Add del objeto Controls permite añadir un nuevo control a la co- 
lección de controles del formulario. 


Una vez ejecutados los pasos anteriores, la clase Form] puede quedar así (se 


han omitido los métodos ya expuestos): 


using System; // Clases fundamentales. 
using System.Windows.Forms; // Clase Form. 
using System.Drawing; // Objetos gráficos. 


public class Forml : Form 


( 


// Atributos 
private Label etSaludo; 
Fd 


// Métodos 
/1 


public Forml() : base() 


( 


IniciarComponentes(); 
) 
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public void IniciarComponentes() 
( 
// Construir aquí los controles 
etSaludo = new Label(); 


// Iniciar la etiqueta etSaludo 





etSaludo.Name = "etSaludo"; 
etSaludo.Text = "etiqueta"; 
etSaludo.Font = new Font("Microsoft Sans Serif", 14, 


FontStyle.Regular); 














etSaludo.TextAlign = ContentAlignment.MiddleCenter; 
etSaludo.Location = new Point(53, 48); 
etSaludo.Size = new Size(187, 35); 
etSaludo.Tablndex = 1; 


// Iniciar formulario: objeto de la clase Forml 
ClientSize = new Size(292, 191); // tamaño 
Name = "Forml"; // nombre 
Text = "Saludo"; // título 








Controls.Add(etSaludo):; 
) 


1/ 
) 


Añadir un botón de pulsación y editar sus propiedades 


Para añadir un botón de pulsación los pasos son similares a los expuestos para 
añadir una etiqueta (las propiedades que se vayan repitiendo no las volveremos a 
comentar por tener un significado análogo; para más detalles recurra a la ayuda). 
El siguiente código crea un botón de pulsación titulado “Haga clic aquí” y esta- 
blece como tecla de acceso la c (se coloca un & antes de la letra c). A continua- 
ción, se asigna una descripción abreviada al botón. 


1. Añada a la clase Form] una variable de tipo Button denominada btSaludo: 


private Button btSaludo; 


2. Cree un objeto Button referenciado por btSaludo. Para ello, añada al método 
IniciarComponentes el código siguiente: 


btSaludo = new Button(); 
3. Modifique sus propiedades según se indica a continuación: 


btSaludo.Name = "btSaludo”; 
btSaludo.Text = "Haga 4clic aquí"; 
btSaludo.Location = new Point(53, 90); 
O 
O. 





btSaludo.Size = new Size(187, 23); 
btSaludo.!1 

















Tablndex = 0; 
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4. Finalmente, añada el botón a la colección de controles del formulario. 
Controls.Add(btSaludo):; 


Añadir una descripción abreviada a un componente 
Una descripción abreviada se mostrará cuando el puntero del ratón se sitúe enci- 
ma del componente. Para añadir una descripción abreviada a un componente siga 


los pasos indicados a continuación: 


1. Añada a la clase Form] una variable de tipo ToolTip denominada ttToo/Tipl: 





private ToolTip ttToolTipl; 


2. Cree un objeto ToolTip referenciado por ttToo/Tip1. Para ello añada al méto- 
do IniciarComponentes el código siguiente: 





ttToolTip1 = new ToolTip(); 


3. Finalmente, añada al botón la descripción abreviada que desee. Por ejemplo: 











ttToolTip1.SetToolTip(btSaludo, "Botón de pulsación"); 


4. El método SetToolTip del objeto ttToo!Tip1 permite añadir una descripción 
abreviada al componente especificado en su primer argumento. Un mismo ob- 
jeto ToolTip puede ser utilizado por varios componentes; esto es, actúa como 
una colección de componentes y sus correspondientes descripciones. 


Una vez ejecutados los pasos anteriores, la clase Form] puede quedar así (se 
han omitido los métodos ya expuestos): 


using System; // Clases fundamentales. 
using System.Windows.Forms; // Clase Form. 
using System.Drawing; // Objetos gráficos. 


public class Forml : Form 

( 
// Atributos 
private Label etSaludo; 
private Button btSaludo; 
private ToolTip ttlToolTipl; 





// Métodos 
// 


public Forml() : base() 
( 

IniciarComponentes(); 
) 
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public void IniciarComponentes() 
( 
// Construir aquí los controles 
etSaludo = new Label(); 
btSaludo = new Button(); 
ttToolTipl = new ToolTip(); 





// Iniciar la etiqueta etSaludo 





etSaludo.Name = "etSaludo”; 
etSaludo.Text = "etiqueta"; 
etSaludo.Font = new Font("Microsoft Sans Serif", 14, 


FontStyle.Regular); 





etSaludo.TextAlign = ContentAlignment.MiddleCenter; 
etSaludo.Location = new Point(53, 48); 
etSaludo.Size = new Size(187, 35); 
etSaludo.TabIndex = 1; 





// Iniciar el botón btSaludo 

btSaludo.Name = "btSaludo"; 

pesao Text = heaga «elie acti" 

btSaludo.Location = new Point(53, 90); 

btSaludo.Size = new Size(187, 23); 

btSaludo.Tablndex = 0; 

ttTloolTip1.SetToolTip(btSaludo, "Botón de pulsación”); 














// Iniciar formulario: objeto de la clase Forml 
ClientSize = new Size(292, 191); // tamaño 
Name = "Forml"; // nombre 
Text = "Saludo"; // título 





Controls.Add(etSaludo); 
Controls.Add(btSaludo); 





) 
1/ 


El proceso de añadir los componentes resulta muy sencillo cuando utilizamos 
Visual Studio, como hicimos en el capítulo 2. Simplemente tenemos que tomar los 
componentes de una paleta y dibujarlos sobre el formulario utilizando el ratón. 
Esto hace que se añada automáticamente todo el código descrito anteriormente. 


CONTROL DE EVENTOS 


Cuando una acción sobre un componente genera un evento, se espera que suceda 
algo, entendiendo por evento un mensaje que un objeto envía a algún otro objeto. 
Entonces hay un origen del evento, por ejemplo, un botón, y un receptor del mis- 
mo, por ejemplo, la ventana que contiene ese botón. Lógicamente, ese algo hay 
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que programarlo y para ello, hay que saber cómo controlar ese evento. Los even- 
tos que se producen sobre un componente se manipulan a través de los controla- 
dores de esos eventos. Un controlador de eventos es un objeto en el que un com- 
ponente delega la tarea de manipular un tipo particular de eventos. 


En la figura siguiente puede ver que cuando un componente genera un evento, 
un controlador de eventos vinculado con el componente se encarga de responder 
al mismo ejecutando el método programado para ello. 






Controlador de 
eventos 










ocurrido 









Método 
(respuesta al evento) 


Como vemos, se necesita un intermediario entre el origen del evento y el re- 
ceptor del mismo que especifique el método que responderá al evento. La clase 
que define ese método se dice que se suscribe al evento. Por ejemplo, en el código 
siguiente observamos que Form] se ha suscrito al evento Click de btSaludo: 


public class Forml : Form 
( 
private Button btSaludo; 
// 


public Forml() : base() 
( 





IniciarComponentes(); 
) 


public void IniciarComponentes() 

( 
ED io 
btSaludo.Click += new EventHandler(btSaludo_Click); 
/1 

) 


private void btSaludo_Click(object sender, EventArgs e) 
{ 

E 
} 


1! 
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El controlador de eventos, que recibe también el nombre de delegado, es un 
objeto de una clase que guarda una referencia al método que responderá a ese 
evento (por ejemplo, podría ser la clase de delegado predefinida EventHandler 
del espacio de nombres System o bien una personalizada denominada de la forma 
NombreEventoEventHandler). Esto es, el delegado es un objeto que representa 
específicamente un método controlador de un evento, de ahí que este método re- 
ciba habitualmente la denominación de “controlador de eventos”. 


Los delegados personalizados solo son necesarios cuando un evento vincula 
datos relacionados con el mismo (véase el apartado Añadir eventos del capítulo 
Construcción de controles). Hay muchos eventos, como los clics, que no vinculan 
datos relacionados con ellos. En estos casos es cuando se utiliza el delegado 


EventHandler. 


La tabla siguiente muestra los eventos más comunes: 


Evento Se produce cuando 

AutoSizeChanged La propiedad AutoSize de un objeto cambia. 

BackColorChanged El color de fondo de un objeto cambia. 

Click Se hace clic sobre un objeto. 

ContextMenuStrip- El valor de la propiedad ContextMenuStrip de un 

Changed objeto cambia. 

ControlAdded Se añade un nuevo control a la colección ControlCo- 
llection. 

ControlRemoved Se elimina un control de la colección ControlCollection. 

CursorChanged El valor de la propiedad Cursor de un objeto cambia. 

DoubleClick Se hace doble clic sobre un objeto. 

EnabledChanged El valor de la propiedad Enabled de un objeto cambia. 

FontChanged El valor de la propiedad Font de un objeto cambia. 

ForeColorChanged El color del primer plano de un objeto cambia. 

Load Se inicia la carga de un formulario por primera vez. 

Paint El control se tiene que repintar. 

Resize El objeto es redimensionado. 

SizeChanged El valor de la propiedad Size cambia. 

TextChanged El valor de la propiedad Text de un objeto cambia. 

Del foco (se exponen en el orden en el que se producen) 

Enter Se entra en el control. 

GotFocus El control recibe el foco. 

Leave Se sale del control. 

Validating El control se está validando. 

Validated El control está validado. 

LostFocus El control pierde el foco. 

Del teclado (se exponen en el orden en el que se producen) 
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KeyDown Se pulsa una tecla mientras el control tiene el foco. 

KeyPress Una tecla está pulsada mientras el control tiene el foco. 

KeyUp Una tecla es soltada mientras el control tiene el foco. 

Del ratón (se exponen en el orden en el que se producen) 

MouseEnter El puntero del ratón entra en un objeto. 

MouseMove El puntero del ratón se mueve sobre un objeto. 

MouseHover El puntero del ratón se sitúa encima del objeto. 

MouseDown Se presiona un botón del ratón sobre el objeto. 

Mouse Wheel La rueda del ratón se mueve mientras el objeto tiene el 
foco. 

MouseUp El puntero del ratón está encima del control y se suelta 
un botón del ratón. 

MouseLeave El puntero del ratón deja el control. 

De arrastrar y soltar 

DragEnter Un objeto es arrastrado dentro de los límites de otro 
control. 

DragOver Un objeto se mueve dentro de los límites de otro con- 
trol. 

DragDrop Se completa una operación de arrastrar y soltar. 

DragLeave Un objeto es arrastrado fuera de los límites de otro 


control. 


Asignar controladores de eventos a un objeto 


Un objeto, generalmente un componente, puede tener asociados tantos controlado- 
res de eventos como eventos del mismo haya que controlar, incluso podría haber 
más de un controlador para un evento determinado. 


Por ejemplo, para que la etiqueta etSaludo muestre el mensaje “¡¡¡Hola mun- 
do!!!” cuando el usuario de nuestra aplicación haga clic en el botón btSaludo, bas- 
ta con suscribir la clase Form] al evento Click de este botón: 


private void btSaludo_Click(object sender, EventArgs e) 
( 
etSaludo.Text = "iiiHola mundo!!!"; 


} 


En general, el primer parámetro del método hace referencia al objeto que pro- 
duce el evento y el segundo contiene información que depende del evento produ- 
cido. En este caso, por tratarse del evento Click, no hay datos relacionados con el 
evento, según explicamos anteriormente, de ahí que el tipo del segundo parámetro 
sea EventArgs, en otro caso, cuando hay datos relacionados con el evento, sería 
una clase derivada de esta. 
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Una vez añadido el método btSaludo Click, ¿cómo se indica que este es el 
controlador del evento Click? Creando un delegado de tipo EventHandler, pa- 
sándole el nombre del método y añadiendo este delegado a la lista de delegados 
que serán llamados cuando el evento Click sea generado. Para añadir un delegado 
se utiliza el operador += y para quitarlo de la lista, el operador =. 


btSaludo.Click += new EventHandler(btSaludo_Click):; 


La sentencia anterior podría escribirse también así: 


btSaludo.Click += btSaludo_Click; 


CICLO DE VIDA DE UN FORMULARIO 


Como con cualquier objeto de cualquier clase, el ciclo de vida de un formulario 
(una ventana) comienza cuando se crea por primera vez un objeto de su clase, 
después se abre, se activa, se desactiva y, finalmente, se cierra. 


Cuando se abre un formulario se agrega automáticamente su referencia a la 
colección de formularios referenciada por la propiedad OpenForms del objeto 
Application y si además se pasa como argumento al método Application.Run, se 
establece, de forma predeterminada, como el formulario principal de la aplicación. 
Puede verificar todo lo que vamos a explicar en este apartado y siguientes creando 
una nueva aplicación Ap WinForms. 


namespace ApWinForms 
static class Program 
static void Main() 
Application.Run(new Forml()):; 
) 


Cuando se inicia la aplicación, el formulario especificado como argumento de 
Run se abre de forma no modal (internamente, el formulario se abre llamando a 
su método Show). Un formulario no modal permite a los usuarios activar otros 
formularios en la misma aplicación; lo contrario sería un formulario modal, que se 
abre con ShowDialog. 


Cuando se abre un formulario, este genera el evento Load y se convierte en el 
formulario activo, lo cual hace que se genere el evento Activated (el formulario 
activo es aquel que está capturando los datos proporcionados por el usuario, tales 
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como las teclas pulsadas y los clics del ratón) y a continuación se genera el evento 
Shown; cuando se produce este último evento puede considerarse abierto el for- 
mulario. También se puede especificar la posición inicial del formulario la prime- 
ra vez que se muestra estableciendo su propiedad StartPosition. 


Cuando un formulario está activo, un usuario puede activar otro formulario de 
la misma aplicación o activar otra aplicación. Entonces, el formulario activo pasa 
a estar desactivado produciéndose el evento Deactivate y cuando se vuelva a ac- 
tivar, se volverá a producir el evento Activated. Para obtener el formulario ac- 
tualmente activo para una aplicación basta con acceder a la propiedad static Acti- 
veForm. Por ejemplo, el código siguiente obtiene el formulario activo y deshabi- 
lita todos los controles del mismo: 


Form FormActivo = Form.ActiveForm; 
for (int i = 0; i < FormActivo.Controls.Count; i++) 
FormActivo.Controls[i].Enabled = false; 


Cuando se desactiva un formulario puede que la aplicación continúe ejecu- 
tando código en segundo plano. En este caso, cuando se complete la tarea en se- 
gundo plano es posible avisar al usuario invocando al método Activate, lo cual 
hará parpadear el botón de la barra de tareas del formulario en el supuesto de que 
el usuario esté interactuando con otra aplicación o traerá el formulario al primer 
plano si el usuario está interactuando con la aplicación actual. 


Un formulario minimizado se contrae en un botón en la barra de tareas si su 
propiedad ShowInTaskbar vale true. 


Cuando se cierra un formulario se generan los eventos FormClosing, antes de 
que el formulario se cierre y con la posibilidad de detener esta acción, FormClo- 
sed y Deactivate; FormClosed se genera justo en el instante en el que el formula- 
rio se va a cerrar y sin posibilidad de detener esta acción. 


Puede probar el ciclo de vida del formulario de la aplicación ApWinForms 
añadiendo los controladores para los distintos eventos comentados. Por ejemplo: 


private void Forml_Load(object sender, EventArgs e) 
( 

System.Diagnostics.Debug.Writeline("Evento Load"); 
) 


Una vez añadidos estos controladores, ejecute la aplicación en modo depura- 
ción (F5) para ver los distintos mensajes en la ventana de resultados. 
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PROPIEDADES BÁSICAS DE UN FORMULARIO 


Anteriormente hemos hablado del ciclo de vida de un formulario, pero no hemos 
hablado mucho de sus propiedades; es justo lo que vamos a hacer a continuación. 


Un formulario se compone de dos áreas distintas: área no cliente y área clien- 
te. El área no cliente comprende los elementos gráficos comunes a todos los for- 
mularios: menú del sistema, icono, título, botón para minimizar, botón para ma- 
ximizar, botón para cerrar y un borde; el área cliente es la parte del formulario 
destinada a ubicar los controles que formarán la interfaz gráfica. 


La clase Form proporciona servicios para administrar la duración del formu- 
lario, para administrarlo y para establecer su apariencia y comportamiento. 


Administración de la duración 


A continuación describimos la funcionalidad más destacada relacionada con la 
duración del formulario. 


e Método Activate. Permite activar el formulario situándolo en primer plano. 
Cuando esto sucede se produce el evento Activated y cuando se desactiva, 
porque se activa otro formulario, se produce el evento Deactivate. 


e Método Close. Permite cerrar el formulario. Cuando se cierra un formulario 
se produce el evento FormClosing, se quita el objeto Form de la colección 
referenciada por OpenForms, se produce el evento FormClosed y se elimi- 
nan los recursos no administrados creados por el objeto Form. 


e Métodos Show y Hide. Show muestra un formulario sin impedir que los 
usuarios interactúen con otros formularios de la aplicación y Hide lo oculta. 
Cuando se oculta un formulario, este no se cierra y la propiedad Visible toma 
el valor false. 


Administración de formularios 


Respecto a la funcionalidad relativa a la administración de los formularios, desta- 
camos la siguiente: 


e Propiedad OwnedForms. Referencia la colección de formularios (matriz de 
objetos Form) de los que este formulario es el propietario. 
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e Propiedad Owner. Obtiene o establece la referencia al formulario propietario 
de este objeto Form. 


Apariencia y comportamiento 


A continuación describimos la funcionalidad más destacada relacionada con la 
apariencia y comportamiento de los formularios. 


e Propiedad AllowsTransparency. Esta propiedad vale true si el formulario 
admite la transparencia y false en caso contrario. 


e Propiedad Icon. Permite establecer el icono de un formulario. 


e Propiedades Top y Left. Estas propiedades permiten obtener o establecer la 
posición de los bordes superior e izquierdo del formulario, respectivamente, 
con respecto al escritorio. Por lo tanto, podrían ser utilizadas para establecer 
la posición inicial del formulario. 


e Evento LocationChanged. Se produce cuando un formulario cambia de posi- 
ción. 


e Propiedad ShowInTaskbar. Si el valor de esta propiedad es true, valor pre- 
determinado, y se minimiza el formulario, este se muestra en la barra de ta- 
reas. 


e Propiedad Topmost. Orden Z de las ventanas. Cuando esta propiedad vale 
true, el formulario correspondiente aparece encima de todos los formularios 
cuya propiedad Topmost valga false y dentro de los formularios que tienen 
esta propiedad a true, el formulario actualmente activado es el formulario de 
nivel superior. 


e Propiedad StartupPosition. Permite obtener o establecer la posición de un 
formulario cuando se muestra por primera vez. Si su valor es Manual, valor 
predeterminado, la posición del formulario queda definida por sus propieda- 
des Top y Left; si estas propiedades no se especifican, entonces Windows de- 
terminará sus valores. Si su valor es CenterScreen, el formulario se coloca en 
el centro de la pantalla que contiene el cursor del ratón. Y si su valor es Cen- 
terParent, el formulario se coloca en el centro del formulario propietario si se 
especificó alguno. 


e Propiedad RestoreBounds. Esta propiedad se puede usar para guardar el ta- 
maño y la ubicación (objeto Rectangle) de un formulario antes de que se cie- 
rre la aplicación y recuperar esos valores la próxima vez que se inicie la apli- 
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cación para que el formulario se muestre con esos valores. El valor de Resto- 
reBounds solo es válido cuando WindowsState no es igual a Normal. 


Propiedad WindowsState. El valor de esta propiedad indica si un formulario 
está restaurado (Normal), minimizado (Minimized) o maximizado (Maximi- 


zed). 


Propiedad FormBorderStyle. Indica el estilo del borde de un formulario. Su 
valor puede ser None, FixedSingle, Fixed3D, FixedDialog y FixedToolWin- 
dow, que no permiten cambiar el tamaño del formulario, y Sizable (es el valor 
predeterminado) y SizableToo!Window, que sí permiten cambiar el tamaño del 
formulario. 


CONFIGURACIÓN DE UNA APLICACIÓN 


El ejemplo que se muestra a continuación indica cómo al iniciar una aplicación se 
pueden restaurar los valores de tamaño, ubicación y estado del formulario princi- 
pal que se guardaron la última vez que se cerró la aplicación. Los valores guarda- 
dos corresponden a las propiedades RestoreBounds y WindowState. 


public partial class Forml : Form 


( 


public Forml() 
( 
InitializeComponent(); 
try 
( 
// Restaurar el estado desde los atributos del objeto 
// de la clase Settings referenciado por Default 
Rectangle restoreBounds = 
Properties.Settings.Default.MainRestoreBounds; 
Left = restoreBounds.Left; 
Top = restoreBounds.Top; 
idth = restoreBounds.Width; 
Height = restoreBounds.Height; 
indowState = Properties.Settings.Default.MainWindowState; 





) 
catch { ) 
) 





private void Forml_FormClosing(object sender, 
FormClosingEventArgs e) 
( 
// Guardar el estado desde los atributos 
if (this.WindowState == FormWindowState.Normal) 
Properties.Settings.Default.MainRestoreBounds = this.DesktopBounds; 
else 
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Properties.Settings.Default.MainRestoreBounds = RestoreBounads; 
Properties.Settings.Default.MainWindowState = WindowState; 
Properties.Settings.Default.Save(); 

) 


El código anterior requiere un par de parámetros de configuración que hemos 
denominado MainRestoreBounds de tipo System.Drawing.Rectangle y 
MainWindowState de tipo System.Windows.Forms.FormWindowsState. Para 
añadirlos ejecute Proyecto > Propiedades > Configuración. Estos parámetros 
quedarán registrados en el fichero 4pp.config y serán definidos como propiedades 
de la clase Settings localizada en el fichero Settings. Designer.cs de la carpeta 
Properties del proyecto, según muestra la figura siguiente, y pueden ser recupera- 
dos a través de las propiedades del mismo nombre de dicha clase. En el código 
anterior, Default es una propiedad static que representa el objeto Settings que da 
acceso a las propiedades mencionadas (para más detalles vea en el proyecto la de- 
finición de esta clase). 


Explorador de soluciones ENX 
6 0-09 ora” 
Buscar en el Explorador de soluciones (Ctrl + P~- 
E Solución 'ApWinForms' (1 proyecto) 
4 E] ApWinForms 
4 ġa Properties 
b œ Assemblylnfo.cs 





4 0 Resources.resx 
b 7) Resources.Designer.cs 
4 (3 Settings.settings 
b EA) Settings.Designer.cs 
D am References 


YA App.config 
> Forml.cs 
b œ Program.cs 


Observe que cuando se inicia la aplicación, el constructor del formulario prin- 
cipal fija la posición y el tamaño del formulario, así como el estado del mismo, 
con los valores guardados cuando se cerró el formulario por última vez. ¿Cuándo 
salvamos estos valores? Cuando se solicite cerrar el formulario: evento Form- 
Closing. En este momento guardamos el valor de la propiedad DesktopBounds o 
RestoreBounds en el parámetro MainRestoreBounds y el valor de la propiedad 
WindowState en el parámetro MainWindowState. Recuerde que RestoreBounds 
solo es válido cuando WindowState no es igual a Normal, de ahí que para este 
estado hayamos recuperado los valores de la propiedad DesktopBounds, la cual 
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permite acceder al tamaño y a la posición del formulario en el escritorio de Win- 
dows. 


RECURSOS DE UNA APLICACIÓN 


Para almacenar y administrar recursos específicos de una aplicación, el espacio de 
nombres System.Resources proporciona diversas clases e interfaces, de las cuales 
la más importante es la clase ResourceManager. La funcionalidad proporcionada 
por esta clase permite al usuario acceder y controlar los recursos almacenados en 
el ensamblado principal o en ensamblados satélite de recursos; por ejemplo, los 
métodos GetObject y GetString permiten recuperar, respectivamente, objetos y 
cadenas específicos. 


Como ejemplo, vamos a almacenar el título del formulario como un recurso 
TituloAplicacion de tipo string. Para añadirlo ejecute Proyecto > Propiedades > 
Recursos. Después, podrá recuperar este recurso así: 


public Forml() 
( 

InitializeComponent(); 

// 

this.Text = Properties.Resources.TituloAplicacion; 
) 


Este recurso ha sido almacenado en el fichero XML Resources.resx de la car- 
peta Properties del proyecto, según muestra la figura anterior, y para acceder al 
mismo, utilizaremos la funcionalidad proporcionada por la clase Resources del 
espacio de nombres Properties localizada en el fichero de código subyacente Re- 
sources.Designer.cs. Si echa una ojeada a esta clase, observará que define una 
propiedad static que da acceso al recurso, cuyo código se muestra a continuación, 
del mismo nombre que el recurso: 


internal static string TituloAplicacion 
( 


get 
( 
return ResourceManager.GetString("TituloAplicacion”, 
resourceCulture); 


Una de las ventajas de definir un recurso así es que podemos modificarlo edi- 
tando el fichero XML Resources.resx sin que sea necesario volver a compilar la 
aplicación. 
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Otro ejemplo: si quisiéramos añadir un icono personalizado a la ventana prin- 
cipal de la aplicación, crearíamos el fichero .ico con la imagen y se la asignaría- 
mos a la propiedad Icon de la ventana (objeto Form). Dicha imagen es almacena- 
da en el proyecto como un recurso embebido y el código que se añadirá a la clase 
que define la ventana, por ejemplo a Form]l, será el siguiente: 


this.Icon = (System.Drawing.Icon)resources.Get0bject("$this.Icon"); 


El recurso $this.Icon corresponde a la imagen binaria del icono definida en el 
fichero Forml.resx. 


Para editar un recurso utilizando el editor predeterminado, diríjase al explora- 
dor de soluciones, haga clic con el botón secundario del ratón en la carpeta del 
proyecto, seleccione Propiedades en el menú contextual que se visualiza, haga 
clic en la pestaña Recursos, seleccione el tipo de recurso en la primera lista des- 
plegable y elija en la segunda lista desplegable, Agregar recurso, la opción que se 
ajuste a la operación que desea realizar. Esta operación añadirá al proyecto una 
carpeta Resources con los recursos. 


ATRIBUTOS GLOBALES DE UNA APLICACIÓN 


Los atributos globales se aplican a todo un ensamblado. Su sintaxis es: 


Tassembly: atributo("valor")] 


Por ejemplo, el fichero AssemblyInfo.cs localizado en la carpeta Properties 
del proyecto, según puede ver en la figura anterior, define los siguientes atributos 
cuyo valor puede usted editar: 





Tassembly: AssemblyTitle("ApWinForms")] 

[assembly: AssemblyDescription("Recursos de una aplicación WinForms")] 
[assembly: AssemblyConfiguration("")] 

[assembly: AssemblyCompany("FJCS")] 

[assembly: AssemblyProduct("ApWinForms")] 

[assembly: AssemblyCopyright("Copyright O Fco. Javier Ceballos")] 
[assembly: AssemblyTrademark("")] 

[assembly: AssemblyCulture("")] 

[assembly: AssemblyFileVersion("1.0.0.0")] 



































Estos atributos globales se pueden especificar después de las directivas de ni- 
vel superior using y antes de las declaraciones de tipo o de espacio de nombres. 


Definir estos atributos en el código fuente tendría poco valor si no se dispu- 
siese de un método para recuperar la información que guardan y actuar sobre ella. 
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Pues bien, esto puede hacerse mediante el uso de la reflexión: característica que 
permite almacenar y obtener información durante la ejecución sobre casi cual- 
quier objeto o tipo presente en un módulo gracias a la funcionalidad proporciona- 
da por las clases del espacio de nombres System.Reflection. 


A este espacio de nombres pertenece la clase Assembly. Un objeto de esta 
clase representa un ensamblado; concretamente, el ensamblado de la aplicación 
actualmente en ejecución es proporcionado por el método static GetExecuting- 
Assembly. El método más importante del ensamblado es GetCustomAttributes, 
el cual devuelve una matriz de objetos que son los equivalentes durante la ejecu- 
ción de los atributos del código fuente. Por ejemplo, el siguiente código obtiene la 
información dada por el atributo AssemblyTitleAttribute: 


object[] atributos = Assembly.GetExecutingAssembly(). 
GetCustomAttributes(typeof(AssemblyTitleAttribute), false); 
string titulo = ((AssemblyTitleAttribute)atributos[0]).Title; 


De acuerdo con los atributos globales definidos en el ejemplo anterior, el titu- 
lo obtenido sería ApWinForms. 


Esta técnica la podemos aplicar para mostrar los créditos de una aplicación en 
un diálogo (véase el apartado Diálogo acerca de del capítulo Controles y cajas de 
diálogo). 


CICLO DE VIDA DE UNA APLICACIÓN 


Una aplicación Windows Forms se inicia invocando al método Main, el cual tiene 
que invocar al método Application.Run para iniciar el enrutamiento de eventos 
Windows Forms necesario para procesar los eventos para los que la aplicación fue 
programada. El código mostrado a continuación es la forma más simple de poner 
en marcha una aplicación: 


namespace ApWinForms 
static class Program 
static void Main() 
i Application.Run(new Forml()); 
) 


Cuando se invoca el método Run pasando como argumento un formulario, 
ese formulario pasará a ser la ventana principal de la aplicación, asignando su re- 
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ferencia a la colección de formularios referenciada por la propiedad OpenForms 
del objeto Application. 


Durante el ciclo de vida de la aplicación, son varios los eventos static genera- 
dos por el objeto Application; por ejemplo, Idle se genera cuando la aplicación 
finaliza el procesamiento de los eventos de su cola de eventos y está a punto de 
entrar en el estado inactivo o ThreadExit se genera cuando un subproceso está a 
punto de cerrarse; además, si este subproceso coincide con el subproceso principal 
de la aplicación, este evento es seguido por el evento ApplicationExit que se ge- 
nera cuando la aplicación está a punto de cerrarse. La aplicación puede suscribirse 
a estos eventos en cualquier momento, pero es muy común hacerlo en el método 
Main. Por ejemplo: 


static void Main() 

( 
Application.ApplicationExit += new EventHandler(OnApplicationExit); 
Application.Runínew Form1()); 

) 


private static void OnApplicationExit(object sender, EventArgs e) 
( 

1! 
) 


Otro evento de interés generado por el objeto Application es ThreadExcep- 
tion. Este evento se produce cada vez que el proceso que controla la interfaz grá- 
fica de usuario lanza una excepción. Este es tan importante que Windows Forms 
proporciona un controlador por defecto por si la aplicación no proporciona uno. 
En el caso de que necesitáramos proporcionar nuestra propia versión del controla- 
dor de este evento, lo haríamos de la forma siguiente: 


static void Main() 

( 
Application.ThreadException += OnThreadException; 
Application.Runí(new Forml()):; 

) 


private static void OnThreadException(object sender, 
System.Threading.ThreadExceptionEventArgs e) 
( 
t 
) 
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Permitir una sola instancia de la aplicación 


Si quisiéramos impedir que se creara más de una instancia de nuestra aplicación, 
básicamente, lo que tendríamos que hacer sería verificar, cuando se inicie la eje- 
cución de Main, si ya hay otra instancia de la aplicación en ejecución. La forma 
más sencilla de hacerlo es utilizar un Mutex del sistema (un objeto de sincroniza- 
ción que proporciona el sistema operativo que permite la comunicación entre pro- 
cesos). Según lo expuesto, podríamos escribir un método Primeralnstancia que 
devolviera un valor true si, al ejecutar la aplicación, se tratara de la primera ins- 
tancia de la aplicación, método que invocaríamos desde Main así: 


static void Main() 
( 
if (Primeralnstancia) 
( 
Application.EnableVisualStyles(); 
Application.SetCompatibleTextRenderingDefault(false); 
Application.Runínew Form1()); 
) 
else 
( 
MessageBox.Show("La aplicación ya se está ejecutando"); 
Application.Exit(); 
) 
) 


private static bool Primeralnstancia 
{ 
get 
{ 
// Verificar si ya existe una instancia de la aplicación 
System.Threading.Mutex exmut ; 
string nombre_exmut = "ApWinForms"; 
bool nueva; 
exmut = new System.Threading.Mutex(true, nombre_exmut, out nueva); 
return nueva; 


Observe que el método Primeralnstancia define un objeto exmut para refe- 
renciar a un objeto de exclusión mutua. Dicho objeto lo creamos con nombre para 
que actúe como una exclusión mutua del sistema, ya que este tipo de Mutex es vi- 
sible en todo el sistema operativo, cosa que no ocurre con la exclusión mutua lo- 
cal sin nombre. La llamada al constructor Mutex tiene tres argumentos: el prime- 
ro es true para otorgar al subproceso que realiza la llamada la propiedad inicial 
del objeto exmut, el segundo para asignar un nombre al Mutex y el tercero devol- 
verá un valor booleano que será true si se creó la exclusión mutua especificada o 
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false si esta ya existe, que es lo que sucederá cuando se intente crear una segunda 
instancia de la aplicación; la palabra reservada out indica que este último argu- 
mento es de salida, por lo que puede ser pasado sin iniciar. 


Argumentos en la línea de órdenes 


Otra de las tareas de iniciación que puede hacer una aplicación Windows Forms 
es procesar los argumentos pasados en la línea de órdenes. Estos parámetros están 
disponibles a través de un parámetro, por ejemplo args, de Main: 


namespace ApWinForms 
static class Program 
: static void Mainístring[] args) 
: // args es la matriz de argumentos en la línea de órdenes 
) 


Cuando se inicia la aplicación, el método Main es el primer método que se 
invoca, esto es, Main es el punto de entrada de una aplicación y este método pue- 
de definir un parámetro que sea una matriz de tipo string para almacenar los ar- 
gumentos que se pasen desde la línea de órdenes cuando se invoque a la aplica- 
ción para su ejecución. 


Por ejemplo, supongamos que queremos dar al usuario de una aplicación la 
opción de iniciar la misma con la ventana principal maximizada. Esto sería fácil 
hacerlo arrancando la aplicación desde la línea de órdenes con una opción que in- 
dique tal acción. Por ejemplo: 


ApWinForms -max 


Para realizar el proceso descrito anteriormente, vamos a añadir al método 
Main el código que permita verificar si se pasó el argumento /max o max. En ca- 
so afirmativo, esto es si args/0] es /max o —-max, asignamos a la propiedad Win- 
dowsState del formulario principal el valor Maximized. Finalmente, invocamos al 
método Run pasando el formulario principal como argumento. 


namespace ApWinForms 
( 
static class Program 
( 
static void Mainístring[] args) 


( 
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Forml formPpal = new Forml1(); 


// Argumentos en la línea de órdenes 
if (args.Length > 0) 

{ 
1 Cargsio] == "ma || arast0l == "-max”) 
formPpal.WindowState = FormWindowState.Maximized; 








Application.Run(formPpal); 


Para probar esta funcionalidad desde el entorno de desarrollo, puede especifi- 
car los argumentos en la línea de órdenes en la caja de texto Argumentos de la li- 
nea de comandos del panel Depurar de las propiedades de la aplicación. 


Pantalla de presentación 


En ocasiones, mostrar al usuario la ventana principal de la aplicación puede resul- 
tar lento simplemente porque previamente tienen que ejecutarse una serie de pasos 
necesarios para iniciar dicha aplicación. En estos casos, puede ser una buena idea 
mostrar una pantalla de presentación para informar al usuario de que la iniciación 
de la aplicación está en curso. 


Una pantalla de presentación puede construirse fácilmente cuando el objeto 
aplicación se deriva de la clase WindowsFormsApplicationBase y se muestra, 
estableciendo las propiedades que esta clase define para tal fin, antes de que se 
muestre el formulario principal. La pantalla de presentación, normalmente, se 
muestra en el centro de la pantalla de la máquina del usuario y cuando la aplica- 
ción se carga, la pantalla de presentación desaparece. 


La clase WindowsFormsApplicationBase está definida en el espacio de 
nombres Microsoft.VisualBasic.ApplicationServices perteneciente a la bibliote- 
ca Microsoft.VisualBasic. Por lo tanto, para utilizar esta clase, debemos añadir a 
nuestro proyecto una referencia a esta biblioteca. 


La clase WindowsFormsApplicationBase proporciona propiedades, méto- 
dos y eventos relacionados con la aplicación actual. Pensando en construir una 
pantalla de presentación, vamos a fijarnos en las propiedades: 


e SplashScreen. Esta propiedad permite establecer u obtener el objeto Form 
que utiliza la aplicación como pantalla de presentación. 
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e MinimumSplashScreenDisplayTime. Esta otra propiedad determina la du- 
ración mínima, expresada en milisegundos (el valor predeterminado son 2000 
ms), durante la cual se muestra la pantalla de presentación. Si el formulario 
principal termina de iniciarse en menos tiempo que el especificado por esta 
propiedad, la pantalla de presentación sigue estando visible hasta que transcu- 
rre el tiempo solicitado, momento en el que se muestra el formulario princi- 
pal. Por el contrario, si la aplicación tarda más tiempo en iniciarse, la pantalla 
de presentación se cierra una vez que se activa el formulario principal. 


e CommandLineArgs. Esta propiedad proporciona acceso de solo lectura a los 
argumentos que se especifiquen en línea de órdenes cuando se inicie la apli- 
cación. 


e  MainForm. Esta otra propiedad permite establecer u obtener el objeto Form 
que se utilizará como formulario principal de la aplicación. 


e  IsSinglelnstance. Esta propiedad cuando vale true indica que solo se podrá 
crear una instancia de la aplicación. 


Y también proporciona los métodos: 


e OnCreateSplashScreen. Este método, de manera predeterminada, no hace 
nada. Su finalidad es que sea redefinido en una clase derivada con la intención 
de establecer la propiedad SplashScreen del objeto WindowsFormsApplica- 
tionBase con el formulario que defina la pantalla de presentación. 


e OnCreateMainForm. Este método, de manera predeterminada, no hace na- 
da. Su finalidad es que sea redefinido en una clase derivada con la intención 
de establecer la propiedad MainForm del objeto WindowsFormsApplica- 
tionBase con el formulario principal que visualizará la aplicación. 


e Run. Este método prepara e inicia la aplicación. Tiene un parámetro que es- 
pera recibir la lista de los argumentos especificados en la línea de órdenes 
emitida al invocar a la aplicación para su ejecución (contenido referenciado 
por el parámetro de Main), a la cual se puede acceder a través de la propiedad 
CommandLineArgs. Durante su ejecución invoca al método OnCreate- 
SplashScreen que, a su vez, invoca al método OnRun de la misma clase que, 
a su vez, llama a los métodos OnCreateMainForm, para crear el formulario 
principal de la aplicación, y HideSplashScreen, para cerrar la pantalla de 
presentación. 


Después de esta introducción, para añadir una pantalla de presentación a la 
aplicación ApWinForms siga los pasos indicados a continuación: 
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1. Añada un nuevo formulario al proyecto (por ejemplo, PantallaDePresenta- 
cion) con el diseño que desee para la pantalla de presentación. 


namespace ApWinForms 
public partial class PantallaDePresentacion : Form 
public PantallaDePresentacion() 
InitializeComponent(); 
ConfigurarSplash(); 
) 


private void ConfigurarSplash() 
( 
this.FormBorderStyle = FormBorderStyle.None; 
this.StartPosition = FormStartPosition.CenterScreen; 
) 


Obsérvese que la pantalla de presentación es un formulario sin borde y que se 
mostrará centrado en la pantalla. 


2. Añada una nueva clase, por ejemplo Aplicacion, derivada de Windows- 
FormsApplicationBase que redefina los métodos OnCreateSplashScreen y 
OnCreateMainForm. Esto exige añadir una referencia a la biblioteca Micro- 
soft.VisualBasic. 


namespace ApWinForms 
( 
class Aplicacion : WindowsFormsApplicationBase 
( 
protected override void OnCreateSplashScreen() 
( 
base.OnCreateSplashScreen(); 
// Pantalla de presentación 
this.SplashScreen = new PantallaDePresentacion(); 
this.MinimumSplashScreenDisplayTime = 2000; 
) 


protected override void OnCreateMainForm() 
{ 

base.0nCreateMainForm(); 

this.MainForm = new Form1(); 

// Argumentos en la línea de órdenes 

if (this.CommandLineArgs.Count > 0) 

{ 
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if (this.CommandLineArgs[0] == "/max" || 
this.CommandLineArgs[0] == "-max") 
this.MainForm.WindowState = FormWindowState.Maximized; 


} 
) 
} 


El método OnCreateSplashScreen fija la propiedad SplashScreen del objeto 
aplicación para que referencie el objeto pantalla de presentación y el método 
OnCreateMainForm fija la propiedad MainForm del objeto aplicación para 
que referencie el objeto formulario principal; en nuestro ejemplo, también se 
verifica si el usuario solicitó mostrar el formulario principal maximizado. 


3. Escriba el método Main. 


namespace ApWinForms 
f 
1 
static class Program 
( 
static void Main(string[] args) 
( 
Application.EnableVisualStyles(); 
Application.SetCompatibleTextRenderingDefault(false); 
// Objeto aplicación 
Aplicacion ap = new Aplicacion(); 
ap.Run(args); 


) 


Ahora, cuando ejecute la aplicación, será mostrada inmediatamente la pantalla 
de presentación en el centro de la pantalla. 


La aplicación se está iniciando 3 
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Desde un objeto WindowsFormsApplicationBase resulta también muy sen- 


cillo permitir una sola instancia de la aplicación. Basta con establecer la propiedad 
IsSingleInstance del objeto aplicación al valor true: 


namespace ApWinForms 


( 


class Aplicacion : WindowsFormsApplicationBase 
( 


public Aplicacion() 
( 


// Asegurar que solo habrá una instancia de la aplicación. 


// Se lanza la excepción OnStartupNextInstance. 
this.IsSinglelnstance = 


= rUe; 
} 


CAPÍTULO 4 


O F.J.Ceballos/RA-MA 


INTRODUCCIÓN A WINDOWS 
FORMS 


Por lo estudiado en los capítulos anteriores, seguramente ya tendremos claro que 
Windows Forms es una biblioteca de clases para crear aplicaciones tradicionales 
que muestran una interfaz gráfica construida a base de formularios y controles, in- 
terfaz que, como veremos en capítulos posteriores, enlazaremos a algunos datos. 


Windows Forms es una API gráfica, basada en GDI+ de Win32, que propor- 
ciona acceso a los elementos nativos de Windows. Sustituyó a la biblioteca MFC 
que estaba escrita en C++. Las aplicaciones Windows Forms no tienen acceso al 
hardware de gráficos directamente, sino que lo hacen a través de GDI+ que es 
quien interactúa con los controladores de dispositivo, lo que no deja de ser un in- 
conveniente (por ejemplo, la nueva biblioteca WPF se basa en DirectX para pro- 
porcionar aceleración por hardware eliminando las dependencias de GDI+). Es 
una biblioteca idónea para crear una interfaz de usuario sencilla a base de formu- 
larios y controles. Veamos a continuación un resumen de la jerarquía de clases de 
Windows Forms (WinForms). 


BIBLIOTECA DE CLASES DE WINDOWS FORMS 


La biblioteca de clases de Windows incluye un conjunto de espacios de nombres 
para crear aplicaciones, componentes y controles para formularios Windows 
Forms. La funcionalidad básica para construir este tipo de aplicaciones está con- 
tenida en estos espacios de nombres: 


e System.Windows.Forms. 
e System.ComponentModel y System.Windows.Forms.Design. 
e System.Drawing. 
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El espacio de nombres System.Windows.Forms proporciona clases para el 
desarrollo de aplicaciones Windows a base de ventanas, también denominadas 
“formularios”. Este espacio de nombres contiene la clase Form y muchos otros 
controles, derivados de la clase Control, que se pueden agregar a los formularios 
para crear interfaces de usuario. Ambas clases, y muchas otras, forman parte de la 
jerarquía de clases de Windows Forms según muestra la figura siguiente: 


0 System.Object 
0  System.MarshalByRefObject 
©  System.ComponentModel.Component 
0  System.Windows.Forms. 
0  System.Windows.Forms.ScrollableControl 
9  System.Windows.Forms.ContainerControl 
0 System.Windows.Forms.Form 


Object es la raíz de la jerarquía de clases. Sus métodos son heredados por to- 
das las clases de la jerarquía y son los siguientes: 


e Equals para comparar objetos. 

e Finalize para realizar operaciones de limpieza antes de que un objeto sea re- 
clamado por el recolector de basura. 

e GetHashCode genera un número que se corresponde con el valor del objeto 
que admite el uso de una tabla hash. 

e  ToString crea una cadena de texto que describe un objeto de la clase. 


MarshalByRefObject. Proporciona acceso a los objetos entre diferentes do- 
minios en las aplicaciones que admiten la comunicación remota. 


Component. Permite que las aplicaciones compartan objetos. 


Control. Define la clase base para los controles. Un control es un componen- 
te con una representación visual; por ejemplo, TextBox (caja de texto). En cam- 
bio, un componente es una clase que implementa directa o indirectamente la inter- 
faz System.ComponentModel.IComponent; son objetos que no tienen por qué 
tener una representación visual, que se pueden volver a utilizar y que pueden in- 
teractuar con otros objetos; por ejemplo, ErrorProvider (proveedor de mensajes 
de error; veremos cómo utilizarlo en un ejemplo posterior). 


SerollableControl. Define la clase base para los controles que admiten des- 
plazar su contenido automáticamente. 


ContainerControl. Proporciona funcionalidad para administrar el foco en 
controles que actúan como contenedores de otros controles. 
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Form. Representa una ventana (un formulario) o una caja de diálogo pertene- 
ciente a la interfaz de usuario de una aplicación. 


A continuación, se presenta la jerarquía de las clases más utilizadas, derivadas 


de Control: 


© Component. Proporciona la funcionalidad requerida por todos los componen- 


tes. 


© Control. Clase base para los controles: componentes con una representa- 
ción visual. 


0 


o 


o 


y 
0 


TextBoxBase. Clase para los controles de edición de texto. 

© TextBox. Control para mostrar o editar texto sin formato. 

©  MaskedTextBox. Control que utiliza una máscara para filtrar los 
datos introducidos por el usuario. 

0  RichTextBox. Control para mostrar o editar texto con formato. 

Label. Etiqueta de texto no editable. 

ButtonBase. Clase base para todos los botones. 

© Button. Botón de pulsación. 

0  CheckBox. Casilla de verificación que muestra gráficamente su 
estado: seleccionada o deseleccionada. 

© RadioButton. Botón de opción que muestra gráficamente su es- 
tado: seleccionado o deseleccionado. 

ListControl. Control que permite seleccionar elementos. 

© ListBox. Lista fija de elementos seleccionables. 

© ComboBox. Lista desplegable de elementos seleccionables. 

PictureBox. Control para mostrar una imagen. 

DataGridView. Muestra los datos en una rejilla personalizable. 

GroupBox. Muestra un marco alrededor de un grupo de controles 

con una leyenda opcional. 

ToolBar. Barra de herramientas. 

StatusBar. Barra de estado. 

ScrollBar. Barras de desplazamiento. 

©  HScrollBar. Barra de desplazamiento horizontal. 

©  VScrollBar. Barra de desplazamiento vertical. 

TrackBar. Barra de seguimiento. 

ProgressBar. Barra de progreso. 


Los espacios de nombres System.ComponentModel y System.Windows.- 
Forms.Design proporcionan clases para el desarrollo de controles y componentes. 
El primero proporciona clases que se utilizan para implementar el comportamien- 
to de controles y componentes durante el diseño y la ejecución. Este espacio de 
nombres incluye las clases e interfaces base para implementar atributos, trabajar 
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con convertidores de tipos o establecer enlaces a orígenes de datos. Y el segundo 
contiene clases que administran la configuración durante el diseño y el compor- 
tamiento de los componentes de los formularios Windows Forms. 


Y el espacio de nombres System.Drawing define otros espacios de nombres 
que proporcionan clases para la realización de gráficos y dibujos. Proporciona ac- 
ceso a funciones gráficas básicas de GDI+. Por ejemplo, la clase Graphics pro- 
porciona métodos para dibujar en el dispositivo de pantalla; clases como Rectan- 
gle y Point encapsulan formas primitivas de GDI+; la clase Pen define el lápiz 
con el que se dibujarán líneas y curvas, mientras que las clases derivadas de 
Brush se utilizan para rellenar el interior de las formas. 


CAJAS DE TEXTO, ETIQUETAS Y BOTONES 


Los controles más comunes en una aplicación Windows son las cajas de texto, las 
etiquetas y los botones de pulsación. Las cajas de texto, controles TextBox, son 
particularmente importantes porque permiten tanto introducir datos para una apli- 
cación como visualizar los resultados producidos por la misma. Las etiquetas, 
controles Label, son cajas de texto no modificables por el usuario. Su finalidad es 
informar al usuario de qué tiene que hacer y cuál es la función de cada control. 
Por último, un botón de pulsación, control de la clase Button, permite al usuario 
ejecutar una acción cuando sea preciso. Las clases mencionadas, que proporcio- 
nan la funcionalidad para los controles descritos, se derivan directa o indirecta- 
mente de la clase Control, del espacio de nombres System.Windows.Forms, que 
aporta la funcionalidad común a todos estos controles. 


Como ejemplo, piense en una aplicación que permita convertir grados centí- 
grados a Fahrenheit, y viceversa. Esta aplicación requiere una interfaz con al me- 
nos dos cajas de texto, de manera que cuando el usuario introduzca en una caja 
una temperatura en grados centígrados, en la otra se visualice la temperatura equi- 
valente en grados Fahrenheit, y cuando en esta otra caja se introduzca una tempe- 
ratura en grados Fahrenheit, en la primera se visualice la temperatura correspon- 
diente en grados centígrados. 


Recuerde que una interfaz se define como el medio de comunicación entre el 
usuario y la aplicación. 


Desarrollo de la aplicación 


Antes de crear una aplicación, debemos responder a algunas preguntas como las 
siguientes: 


e ¿Qué objetos forman la interfaz? 
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e ¿Qué eventos hacen que la interfaz responda? 
e ¿Cuáles son los pasos a seguir para un desarrollo ordenado? 


Objetos 
La conversión de temperaturas implica los siguientes objetos: 


Un formulario que permita implementar nuestra interfaz. 

Una caja de texto para introducir/mostrar los grados centígrados. 

Una caja de texto para introducir/mostrar los grados Fahrenheit. 

Dos etiquetas que informen al usuario de la información que contiene cada 
caja de texto. 

e Un botón de pulsación ligado a la tecla Entrar. 


Eventos 


En esta aplicación se quiere que cuando el usuario escriba una temperatura en una 
caja y pulse Entrar, el contenido de la otra caja se actualice automáticamente, y 
viceversa. Por lo tanto, el evento para que se actualicen las cajas de texto es pulsar 
la tecla Entrar, o hacer clic en el botón de pulsación asociado con la tecla Entrar 
que recibe la calificación de botón predeterminado de un formulario. Y, ¿a partir 
de qué caja de texto se hace la conversión? Pues a partir de aquella en la que el 
usuario escribió un nuevo valor, hecho que se puede conocer a través del evento 
“se ha pulsado una tecla” (¿sobre qué caja se escribió la última vez?). 


Cuando una ventana tiene uno o más botones, uno y solo uno de ellos puede 
ser establecido como botón predeterminado, lo que implica que la tecla Entrar 
realice paralelamente su misma función. Como veremos en el desarrollo de la 
aplicación, para hacer que un botón sea el botón predeterminado de un formulario, 
hay que asignar a la propiedad AcceptButton de su contenedor, el formulario, el 
nombre de ese botón; este botón se distinguirá de los demás porque aparecerá ro- 
deado con un borde más oscuro. 


Pasos a seguir durante el desarrollo 


1. Crear el esqueleto para una nueva aplicación que utilice un formulario como 
ventana principal. 


Añadir los controles necesarios al formulario. 
Definir las propiedades de los controles. 
Escribir el código para cada uno de los objetos. 


Guardar la aplicación. 


SIA TO 


Crear un fichero ejecutable. 
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El formulario, los controles y sus propiedades 


Conocidos los objetos y los eventos, procedemos a dibujar la interfaz. Para ello, 
creamos el esqueleto para una nueva aplicación, denominada Conver, que utilice 
un formulario como ventana principal y le asignamos el título “Conversión de 
temperaturas”. 


Los pasos seguidos para escribir el código correspondiente al esqueleto de la 
aplicación ya fueron explicados en el capítulo 2. Por ello, se supone que no pre- 
sentan ya ninguna dificultad (arranque Visual Studio, diríjase a la barra de menús 
y ejecute Archivo > Nuevo Proyecto. En el diálogo que se visualiza, seleccione el 
tipo de proyecto Visual CH > Windows, la plantilla Aplicación de Windows 
Forms, el nombre Conver y haga clic en el botón Aceptar. 


Cuando se ejecute el código generado, se obtendrá un resultado análogo al de 
la figura que se muestra a continuación. Los pasos que hay que seguir para ejecu- 
tar una aplicación también fueron expuestos en el capítulo 2. 


Fi 
al Conversión de temperaturas bank 























El paso siguiente es dibujar sobre el formulario los controles con las propie- 
dades que se especifican en la tabla siguiente: 


Propiedad Valor 


Text Grados centígrados 
Caja de texto (Name) ctGradosC 

Text 0.00 

TextAlign 


Etiqueta (Name) etGradosF 
Text Grados Fahrenheit 
o 
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Botón de pulsación (Name) 


Text 
UserMnemonic 





Una vez finalizado el diseño, la interfaz obtenida será similar a la siguiente: 


e T 
al Conversión de temperaturas bak 








Grados centígrados: 0.00 


Grados Fahrenheit: 32.00 




















Tecla de acceso 


Se puede observar en el título del botón Aceptar que la letra 4 aparece subrayada 
(si no se ve, pulse la tecla 4/1). Esto significa que el usuario podrá también ejecu- 
tar la acción especificada por el botón, pulsando las teclas 4/1+-4. Esta asociación 
tecla-control recibe el calificativo de “nemónico” y se realiza escribiendo el sím- 
bolo ampersand (8) antes de la letra que desea dé acceso al botón. 


Botón predeterminado 


Si echa un vistazo a los botones de las ventanas de su sistema operativo, observa- 
rá que, generalmente, hay un botón con un borde más resaltado que los demás; se 
trata del botón predeterminado: botón que será automáticamente pulsado cuando 
se pulse la tecla Entrar. Para informar al formulario de cuál será el botón prede- 
terminado de entre todos los que contenga, hay que asignar a la propiedad Ac- 
ceptButton del formulario el nombre de ese botón. Cuando realice esta operación 
desde la ventana de propiedades, el asistente añadirá el código siguiente: 


this.AcceptButton = this.btAceptar; 
Responder a los eventos 


Ya tenemos el formulario con sus controles. El paso siguiente es hacer que estos 
controles respondan a las solicitudes que el usuario haga a la aplicación, lo que 
requiere vincular con los mismos el código que debe ejecutarse como respuesta a 
tales solicitudes, las cuales serán transmitidas en forma de eventos. 
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Pues bien, para hacer que una aplicación responda a las acciones del usuario, 
habrá que vincular con cada uno de los elementos que componen la interfaz gráfi- 
ca el código con el que deben responder a cada evento de interés que estos gene- 
ren debido a esas acciones. Este código asociado con cada control y escrito para 
un determinado evento recibe el nombre de “método conducido por un evento”. 
En nuestro ejemplo, estos métodos serán miembros de la clase Form1, derivada 
de System.Windows.Forms.Form, porque es la que define esos controles. 


Siguiendo con el ejemplo, el proceso que deseamos realizar es que cuando un 
usuario escriba una temperatura en una caja de texto y pulse Entrar, se actualice 
automáticamente el contenido de la otra caja con el valor resultante de la conver- 
sión correspondiente. Para realizar la conversión de una temperatura en grados 
centígrados a grados Fahrenheit, y viceversa, utilizaremos las fórmulas siguientes: 


GradosFahr = (GradosCent x 9 / 5) + 32 
GradosCent = (GradosFahr - 32) x 5 / 9 


Para aplicar una u otra fórmula, necesitamos saber en qué caja de texto se ha 
escrito la temperatura a convertir, para lo cual definiremos en la clase Form] la 
variable miembro objTextBox de tipo TextBox. Diríjase a la ventana de código 
(fichero Form1.cs) y escriba: 


public partial class Forml : Form 
( 
private TextBox objlextBox = null; 


1/ 


La palabra reservada partial indica que se está realizando una definición par- 
cial de la clase, lo cual permite definirla en varios ficheros .cs. En nuestro ejem- 
plo, podemos observar que la clase Form]1 viene definida en el fichero Form1.cs y 
se completa en Form1.Designer.cs. 


Cuando el usuario escribe en una caja de texto, cada pulsación produce los 
eventos KeyDown, KeyPress y KeyUp. Para interceptar este tipo de eventos, por 
ejemplo, el segundo, vamos a añadir a la clase Form1, para cada una de las cajas 
de texto, un controlador de eventos KeyPress que tiene la forma siguiente: 


private void nombre_KeyPress(object sender, KeyPressEventArgs e) 
( 


} 
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Este controlador recibe un primer argumento, sender, de tipo object, que hace 
referencia al objeto que generó el evento; y un segundo argumento, e, de tipo 
KeyPressEventArgs, que proporciona las siguientes propiedades: 


e Handled. Esta propiedad de tipo bool permite conocer o establecer si se con- 
troló (true) o no (false) el evento KeyPress; un valor false indica que el 
evento continuará siendo controlado por el controlador predeterminado pro- 
porcionado por la biblioteca Windows Forms. 


e  KeyChar. Esta propiedad, de tipo char, permite obtener, y modificar si fuera 
necesario, el carácter correspondiente a la tecla pulsada. 


Para añadir el controlador mencionado, sitúese en la ventana de diseño, selec- 
cione una caja de texto, diríjase a la ventana de propiedades, haga clic en su botón 
Eventos para mostrar la lista de eventos y haga doble clic sobre el evento 
KeyPress. Repita este proceso para la otra caja de texto. ¿Cuál será la respuesta a 
este evento? En ambos casos la aplicación responderá de la misma forma: alma- 
cenando la referencia a la caja de texto que generó el evento en la variable objTex- 
tBox, que posteriormente interrogaremos para saber sobre qué caja de texto escri- 
bió el usuario, y actualizar a partir de este valor el contenido de la otra. 


private void ctGradosC_KeyPress(object sender, KeyPressEventArgs e) 
( 
objTextBox = (TextBox)sender; 


} 


private void ctGradosF_KeyPress(object sender, KeyPressEventArgs e) 
{ 





objTextBox = (TextBox)sender; 


} 


Se habrá dado cuenta de que podríamos haber utilizado un solo controlador 
para ambas cajas de texto. En este caso porque, para ambas, la respuesta es la 
misma y en otros casos porque a través del parámetro sender podemos identificar 
la caja para la que fue invocado el método. También podríamos haber utilizado un 
controlador de eventos TextChanged. 


Una vez que el usuario haya escrito un valor en una caja de texto, su siguiente 
acción será pulsar la tecla Entrar, o lo que es lo mismo, hacer clic en el botón 
Aceptar. Entonces, para que el botón Aceptar pueda responder al evento “clic”, le 
asociaremos un controlador de eventos Click. Para ello, procediendo de forma 
análoga a como lo hizo anteriormente, añada a la clase Form1 el siguiente contro- 
lador: 
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private void btAceptar_Click(object sender, EventArgs e) 
( 


} 


La finalidad de este método es realizar la operación de conversión. Para ello, 
tiene que interrogar a la variable miembro objTextBox para saber en qué caja de 
texto introdujo el usuario un nuevo valor y aplicar así la fórmula de conversión 
adecuada, visualizando el resultado de la conversión en la otra caja. 


private void btAceptar_Click(object sender, EventArgs e) 
{ 
try 
{ 
double grados; 
// Si se escribió en la caja de texto grados centígrados... 
if (objTextBox == ctGradosC) 
{ 
grados = Convert.ToDouble(ctGradosC.Text) * 9.0 / 5.0 + 32.0; 
// Mostrar el resultado redondeado a dos decimales 
ctGradosF.Text = string.Format("{0:F2}", grados); 
) 
// Si se escribió en la caja de texto grados Fahrenheit... 
if (objTextBox == ctGradosF) 
( 
grados = (Convert.ToDouble(ctGradosF.Text) - 32.0)*5.0 / 9.0; 
// Mostrar el resultado redondeado a dos decimales 
ctGradosC.Text = string.Format("(0:F2)", grados); 
) 
) 
catch (FormatException) 


( 





ctGradosC.Text = "0,00"; 
ctGradosF.Text = "32,00"; 





En el código anterior se puede observar que la propiedad Text hace referencia 
a un objeto string que almacena el contenido de la caja de texto, que es converti- 
do a un valor double utilizando el método Convert.ToDouble. Finalmente, el re- 
sultado de tipo double es convertido a un string invocando al método Format de 
esta clase y visualizado en la caja de texto correspondiente a través de su propie- 
dad Text. En el caso de que el dato introducido no se corresponda con un valor 
numérico, será lanzada una excepción de tipo FormatException que atraparemos 
para que las cajas vuelvan a mostrar sus valores iniciales. 


El código completo de esta aplicación puede obtenerlo del CD en la carpeta 
Cap04|Conver. Compile ahora la aplicación, ejecútela y observe cómo trabaja. 
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Enfocar un objeto 


Cuando un control posee el punto de inserción se dice que dicho control está en- 
focado o que tiene el foco. 


Un usuario de una aplicación puede enfocar un determinado control haciendo 


clic sobre él o bien pulsando la tecla Tab una o más veces hasta situar el foco so- 
bre él. Así mismo, un control también puede ser enfocado desde la propia aplica- 
ción; puede hacerlo de tres maneras: 


1. 


Invocando al método Focus o Select para el control que requiere el foco una 
vez abierto el formulario. Este proceso puede realizarse como respuesta al 
evento Load que se genera cuando se carga el formulario por primera vez. 
Por ejemplo, para enfocar el control ctGradosC de este formulario, añada el 
siguiente controlador a la clase Form]: 


private void Forml_lLoad(object sender, EventArgs e) 
( 
this.Visible = true; 
ctGradosC.Focus(); 

) 





private void Forml_lLoad(object sender, EventArgs e) 
( 

ctGradosC.Select(); 
) 


El método Forml_Load se ejecutará como respuesta al mensaje “cargar for- 
mulario” que se produce una vez que la ventana derivada de la clase Form se 
crea para ser visualizada, pero antes de que se visualice, por lo que hay que 
establecer su propiedad Visible a true si queremos que Focus tenga efecto, o 
bien invocar a su método Select. Otra opción sería utilizar el controlador del 
evento Shown que se produce la primera vez que se muestra la ventana: 


private void Forml_Shown(object sender, EventArgs e) 
( 

ctGradosC.Focus(); 
) 


Según hemos indicado, el usuario puede pasar de un control a otro (entre los 
controles que admiten el foco) pulsando la tecla Tab. El orden que se sigue 
coincide con el orden en el que fueron colocados los controles en la ventana. 
Por lo tanto, otra forma de que un determinado control reciba inicialmente el 
foco es colocándolo el primero, lo que asigna un valor cero a su propiedad 
TabIndex. 
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3. Otra forma de que un determinado control reciba inicialmente el foco es asig- 
nando a su propiedad Tablndex un valor 0 a través de la ventana de propie- 
dades. También podemos acceder al valor de la propiedad TablIndex de todos 
los controles de un formulario, seleccionando el formulario y ejecutando la 
orden Ver > Orden de tabulación. 





al! Conversión de temperaturas a 


dos centígrados: 0.00 
E o 
dos Fahrenheit 32.00 
E E 
A Aceptar 











La secuencia de clic de ratón que haga sobre los controles coincidirá con el 
orden 0, 1, 2, etc. Para finalizar pulse la tecla Esc. 


Seleccionar el texto de una caja de texto 


En la mayoría de las ocasiones requeriremos de una caja de texto cuyo contenido 
sea seleccionado automáticamente cuando reciba el foco. Esto permitirá escribir 
un nuevo contenido sin tener que preocuparse de borrar el existente. 


Según lo expuesto, vamos a añadir a nuestra aplicación el código necesario pa- 
ra que, cuando una caja de texto obtenga el foco, todo su contenido quede selec- 
cionado. Esto es fácil si sabemos que cuando un control obtiene el foco, genera el 
mensaje “foco obtenido” (Enter) y cuando lo pierde, “foco perdido” (Leave). Es- 
tos eventos se producen al cambiar el foco mediante el teclado (tecla Tab). Si lo 
cambiamos haciendo clic con el ratón, controlar el evento MouseClick. 


Entonces vamos a asociar con cada una de las cajas de texto un controlador de 
eventos Enter. Para interceptar este tipo de eventos, añadiremos a la clase Form] 
un controlador como el siguiente: 


private void Cajalexto_Enter(object sender, EventArgs e) 
( 
TextBox ObjlTextBox = (TextBox)sender; 
ObjTextBox.SelectAll1(); 
) 
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Lo que hace este método es obtener el identificador de la caja de texto que ob- 
tiene el foco y enviarle el mensaje SelectAll. El método SelectAll selecciona todo 
el texto de la caja de texto. Repetir este proceso con el evento MouseClick, 


Otras propiedades/métodos relacionados con la selección de texto en un con- 
trol de texto son los siguientes: 


e SelectionStart. Propiedad que permite obtener o establecer el punto de inicio 
del texto seleccionado en la caja de texto. Por ejemplo: 


TextBox1.SelectionStart = 10; 
fija el punto de inserción en la posición 10 de la caja TextBox1 y 


pos = TextBox1.SelectionStart; 


devuelve la posición del punto de inserción. 


e SelectionLength. Propiedad que permite obtener o establecer el número de 
caracteres seleccionados en la caja de texto. Por ejemplo: 


TextBox1.SelectionLength = 5; 
selecciona cinco caracteres a partir del punto de inserción en la caja TextBox1 y 


n = TextBox1.SelectionLength; 


devuelve el número de caracteres seleccionados. 


e SelectedText. Propiedad que permite obtener el texto seleccionado, o bien 
reemplazar el texto seleccionado (puede ser nulo) por otro. Por ejemplo, el 
código siguiente muestra una forma rápida de añadir texto a una caja de texto 
sin necesidad de reescribir el contenido de la caja: 


TextBox1.SelectionStart = TextBox1.Text.Length;//posición final 
TextBox1.Selectedlext = NuevolTexto; //lañadir texto 





e  Select(int pos inicial, int pos final). Selecciona el texto que se encuentra en- 
tre las posiciones especificadas. 


INTERCEPTAR LA TECLA PULSADA 


La aplicación Conver, expuesta anteriormente, requiere el botón por omisión 
Aceptar para que cuando el usuario modifique el contenido de una caja de texto y 
pulse la tecla Entrar, se realice la modificación correspondiente en la otra caja. 
Seguramente usted habrá pensado en eliminar el botón Aceptar y en su lugar in- 
terceptar la tecla Entrar, instante en el que hay que realizar la conversión. 
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Una forma de interceptar la tecla Entrar es asociando un controlador de even- 
tos KeyPress con el componente de texto que recibe tal evento y verificar si se 
pulsó la tecla Entrar. 


Según lo expuesto, vuelva a reproducir la aplicación Conver anterior, pero 
ahora sin el botón de pulsación, sin la variable objTextBox y sin los controladores 
de eventos KeyPress. La llamaremos Conver2. 


F 
al Conversión de temperaturas bak 











Grados centígrados: 0.00] 


Grados Fahrenheit: 32.00 

















Para interceptar la pulsación de la tecla Entrar que el usuario realizará des- 
pués de escribir la cantidad que desea convertir, añadiremos el siguiente controla- 
dor del evento KeyPress para ambas cajas de texto: 


private void CajaTexto_KeyPress(object sender, KeyPressEventArgs e) 
( 
if (e.KeyChar == Convert.ToChar(13)) 
( 
// Se pulso la tecla Entrar 
e.Handled = true; 
Conversioní(sender); 
) 


Como se puede observar, el método CajaTexto KeyPress utiliza la propiedad 
KeyChar para comprobar si se presionó la tecla Entrar. Si se presionó, se asigna 
a la propiedad Handled el valor true, lo que indica que será nuestra aplicación la 
que controlará el evento, impidiendo que se pase el control al controlador prede- 
terminado. ¿Qué es lo que hará nuestra aplicación? Pues invocar al método Con- 
version que convertirá la cantidad tecleada en los grados correspondientes: 


private void Conversion(object sender) 
( 
TextBox objlextBox = (TextBox)sender; 
try 
( 
double grados; 
// Si se escribió en la caja de texto grados centígrados... 
if (objlextBox == ctGradosC) 
( 
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grados = Convert.ToDouble(ctGradosC.Text) * 9.0 / 5.0 + 32.0; 
// Mostrar el resultado redondeado a dos decimales 
ctGradosF.Text = string.Format("([0:F2)", grados); 

) 

// Si se escribió en la caja de texto grados Fahrenheit... 

if (objlTextBox == ctGradosF) 

( 
grados = (Convert.ToDouble(ctGradosF.Text) - 32.0) * 5.0 / 9.0; 
// Mostrar el resultado redondeado a dos decimales 
ctGradosC.Text = string.Format("(0:F2)", grados); 








) 
) 
catch (FormatException) 
( 

ctGradosC.Text = "0,00"; 

ctGradosF.Text = "32,00"; 
) 





} 


El código completo de esta aplicación puede obtenerlo del CD en la carpeta 
Cap04\Conver2. 


VALIDACIÓN DE UN CAMPO DE TEXTO 


Validar un campo de texto equivale a restringir su contenido al conjunto de carac- 
teres válidos para dicho campo. Si la validación de los datos se hace después de 
pulsar la tecla Entrar en la caja de texto, el campo podría contener un dato no vá- 
lido, pero podría ser validado antes de utilizarlo. En cambio, si la validación se 
hace verificando la validez de cada tecla pulsada (evento KeyPress), el campo de 
texto ya estará validado una vez finalizada la entrada. 


¿Qué sucede cuando una caja de texto tiene el foco y el usuario pulsa una te- 
cla? Pues que el control genera tres eventos: KeyDown, KeyPress y KeyUp; el 
primero lo genera cuando se pulsa la tecla, el segundo cuando se va a escribir el 
carácter y el tercero cuando se suelta la tecla. Estos eventos podrán ser intercepta- 
dos y respondidos por los correspondientes métodos, si el control tiene asociado 
un controlador de eventos para cada uno de ellos. Por ejemplo, si quisiéramos 
controlar estos eventos cuando sean generados por una caja de texto TextBoxl, es- 
cribiríamos el siguiente código: 


private void textBox1_KeyDown(object sender, KeyEventArgs e) 
( 

/1 
) 
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private void textBox1_kKeyPress(object sender, KeyPressEventArgs e) 
( 

// 
) 


private void textBox1_KeyUplobject sender, KeyEventArgs e) 
( 

// 
) 


El evento KeyPress, a diferencia de los eventos KeyDown y KeyUp, se ge- 
nera solamente cuando se introduce un carácter ASCII. Esta definición excluye 
teclas especiales, como teclas de función (FZ a F12), teclas de movimiento del 
cursor (— Î —> J) o la tecla Supr (Del). 


El juego de caracteres ASCII incluye todos los caracteres imprimibles, las 
combinaciones Ctri+(4-Z) y otros caracteres estándar como retroceso (ASCII 8 o 
BackSpace) y la tecla Entrar. Para interceptar cualquier otra tecla o combinación 
de teclas que no produzcan un código ASCII, se utilizarán los eventos KeyDown 
y KeyUp. Por ejemplo: 


private void control_KeyDown(object sender, KeyEventArgs e) 
( 
// Si se pulsó (Alt | Control | Shift) + Fl... 
if (e.KeyCode == Keys.Fl 348 (e.Alt || e.Control || e.Shift)) 
( 
LE aus 
} 
// Si se pulsó Alt + F2... 
else if (e.KeyCode == Keys.F2 && e.Modifiers == Keys.Alt) 
{ 
LI sate 
} 
) 


El parámetro KeyEventArgs del controlador proporciona, entre otras, la pro- 
piedad KeyCode, que especifica los códigos de las teclas pulsadas del teclado fí- 
sico; y la propiedad Modifiers, que especifica la combinación de las teclas Ctrl, 
Shift (Mayús) o Alt que se ha pulsado. 


Una alternativa para saber si se pulsaron algunas de las teclas 4A/t, Control o 
Shift (Mayus) es la propiedad ModifierKeys de la clase Control que almacena la 
suma lógica (|) de las teclas 4/t, Shift o Control pulsadas simultáneamente. Por 
ejemplo, el siguiente código verifica si se han pulsado las teclas Shift+Control: 


if ((Control.ModifierKeys 8 (Keys.Shift | Keys.Control)) == 
(Keys.Shift | Keys.Control)) 
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2! 


Apliquemos lo expuesto a la aplicación Conver2. El contenido de las cajas de 


texto ctGradosC y ctGradosF será válido cuando sus caracteres pertenezcan al si- 
guiente conjunto: +-,1234567890. El signo + o — solo puede aparecer al principio 
del dato y este solo puede contener una coma decimal. 


Según lo expuesto, para validar el contenido de las cajas de texto verificando 


cada tecla pulsada podríamos escribir el método CajaTexto KeyPress, controlador 
del evento KeyPress, como se indica a continuación. De forma resumida, este 
método realiza las siguientes operaciones: 


1. 


2. 


Si se pulsó la tecla Entrar (código ASCII 13), da por controlado el evento in- 
vocando al método Conversion. 

Si se pulsó la tecla Retroceso (código ASCII 8), deja que sea el controlador 
predeterminado el que controle el evento para que realice el procesamiento. 

Si se pulsó la tecla Coma y ya había una, invalida esta última dando por con- 
trolado el evento. 

Si se pulsó la tecla + o —, verifica que se trata del primer carácter tecleado. De 
no ser así, invalida este último dando por controlado el evento. En este caso, 
se tiene en cuenta que al escribir el signo como primer carácter, la caja de tex- 
to puede que no esté vacía, pero sí todo el texto seleccionado, en cuyo caso 
será automáticamente reemplazado. Si en la primera posición ya hay un carác- 
ter, invalida este último dando por controlado el evento. 

Si se pulsó otra tecla que no se corresponde con uno de los dígitos O a 9, se 
invalida dando por controlado el evento. 


private void Cajalexto_KeyPress(object sender, KeyPressEventArgs e) 


( 


if (e.KeyChar == Convert.ToChar(13)) 
( 
// Se pulsó la tecla Entrar 
e.Handled = true; 
Conversion(sender); 
) 
else if (e.,KeyChar == Convert.ToChar(8)) 
( 
// Se pulsó la tecla retroceso 
e.Handled = false; 
) 
else if (e.KeyChar == ”*,”) 
( 
TextBox ObjlTextBox = (TextBox)sender; 
if (ObjTextBox.Text.Index0f(”,*) != -1) 
( 
// Solo puede haber una coma 
e.Handled = true; 
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) 
) 
else if (e.,KeyChar == *-” 
( 


e.KeyChar == +”) 


TextBox ObjlTextBox = (TextBox)sender; 

// Admitir - o + solo en la primera posición: 

if (ObjlextBox.SelectionLength == ObjTextBox.TextLength) 
( 





// Todo el texto está seleccionado: se sobrescribe con el signo 
e.Handled = false; 
) 
else if (ObjTextBox.TextLength != 0) 
( 
// La primera posición ya está ocupada 
e.Handled = true; 
) 
) 
else if (e.KeyChar < *0” || e.KeyChar > *9”) 
( 
// Desechar los caracteres que no son dígitos 
e.Handled = true; 
) 
) 


Obsérvese que la tecla pulsada se valida antes de que el controlador prede- 
terminado añada el carácter a la caja de texto. 


Eventos Validating y Validated 


Otra forma de validar el contenido de un control es añadiendo controladores para 
los eventos Validating y Validated. Estos eventos se producen en el orden des- 
crito cuando el control pierde el foco (porque el usuario pulsó la tecla Tab, hizo 
clic con el ratón en otro control, etc.), siempre y cuando su propiedad CausesVa- 
lidation valga true, que es el valor predeterminado. 


En el controlador del evento Validating debe probar una condición determi- 
nada (por ejemplo, probar si el dato es numérico); esto es, el control se está vali- 
dando. Si la prueba da error, debe asignar a la propiedad Cancel del parámetro 
CancelEventArgs del controlador el valor true. Esto cancela el evento Valida- 
ting y devuelve el foco al control. El resultado es que el usuario no puede dejar el 
control hasta que los datos sean válidos, dependiendo esto de la propiedad Auto- 
Validate del formulario que por defecto vale EnablePreventFocusChange. Si la 
prueba no da error (finalizó la validación del control) se produce el evento Vali- 
dated, en cuyo controlador podremos utilizar el dato validado con toda seguridad. 
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Según lo expuesto, vuelva a reproducir la aplicación Conver2 anterior, pero 
ahora añadiendo los controladores para los eventos Validating y Validated. Lla- 
maremos a esta nueva versión de la aplicación Conver3. 


En primer lugar, arrastre desde la caja de herramientas un componente 
ErrorProvider, denomínelo ProveedorDeError. Después, añada a la clase Form] 
un atributo privado datoCajaTexto. Este atributo almacenará el valor numérico, 
procedente de la caja de texto, que se desea convertir. 


private ErrorProvider ProveedorDeError; 
ProveedorDeError = new ErrorProvider(); 
LN tte 

private double datoCajalTexto; 


Para añadir el controlador que validará el dato grados, diríjase a la ventana de 
diseño, seleccione ambas cajas de texto, diríjase a la ventana de propiedades, se- 
leccione el evento Validating y escriba como nombre para el controlador Caja- 
Texto _Validating. De esta forma, ambas cajas utilizarán el mismo controlador. 
Repita el proceso para añadir el controlador CajaTexto_Validated para el evento 
Validated. Después, impleméntelos como se indica a continuación: 


private void Cajalexto_Validating(object sender, CancelEventArgs e) 
( 
TextBox objlTextBox = (TextBox)sender; 
try 
( 
datolajalexto = Convert.ToDouble(objTextBox.Text):; 
) 
catch (Exception) 
( 
e.Cancel = true; 
objTextBox.SelectAl1(); 
ProveedorDeError.SetError(objlextBox, "Tiene que ser numérico"); 


) 


El controlador CajaTexto _Validating prueba a convertir el contenido de la ca- 
ja de texto. Si el método ToDouble no puede realizar la conversión, lanzará una 
excepción que atraparemos para asignar a la propiedad Cancel de CancelEvent- 
Args el valor true, seleccionar todo el texto de la caja para que sea más sencillo 
reemplazarlo por un dato correcto e indicarle al usuario que ha ocurrido un error 
utilizando un objeto ProveedorDeError de la clase ErrorProvider. 


Un objeto System.Windows.Forms.ErrorProvider proporciona un meca- 
nismo simple para indicar al usuario final que se ha producido un error en un de- 
terminado control. El código siguiente indica cómo se utiliza: 
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ProveedorDeError.SetError(objTextBox, "Tiene que ser numérico"); 


El primer argumento del método SetError indica el control para el que se va 
a establecer la descripción del error, y el segundo, la cadena de descripción del 
error, que puede ser vacía. 


Cuando se especifica una cadena de descripción del error para el control, se 
muestra un icono junto a este. El icono parpadea de la manera que especifica la 
propiedad BlinkStyle, con la frecuencia que especifica BlinkRate. Cuando el ra- 
tón pase por encima del icono, se mostrará la descripción del error. 








al] Conversión de temperaturas 








Grados centígrados: 


Grados Fahrenheit: lene que ser numérico 

















S1 lo prefiere, puede notificar el error mediante un diálogo en lugar de utilizar 
un objeto ErrorProvider: 


MessageBox.Show("Tiene que ser numérico"); 


Después de que el usuario introduzca el dato y pulse la tecla Tab, o haga clic 
en otro control, si la prueba no da error, se produce el evento Validated, en cuyo 
controlador podremos realizar las operaciones que sean necesarias. En nuestro ca- 
so, quitar cualquier notificación de error que hubiera e invocar al método Conver- 
sion para realizar esta operación. 


private void Cajalexto_Validated(object sender, EventArgs e) 
( 

ProveedorDeError.Clear(); 

Conversion(sender); 


1 
J 


El método Conversion, puesto que ahora recibe como argumento un dato va- 
lidado, puede ser así: 


private void Conversion(System.Object sender) 
( 
TextBox objlextBox = (TextBox)sender; 
double grados; 
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// Si se escribió en la caja de texto grados centígrados... 
if (objTextBox == ctGradosC) 
( 
grados = datoClajalexto * 9.0 / 5.0 + 32.0; 
// Mostrar el resultado redondeado a dos decimales 
ctGradosF.Text = string.Format("(0:F2)", grados); 
) 
// Si se escribió en la caja de texto grados Fahrenheit... 
if (objTextBox == ctGradosF) 
( 





grados = (datoCajalexto - 32.0) * 5.0 / 9.0; 
// Mostrar el resultado redondeado a dos decimales 
ctGradosC.Text = string.Format("(0:F2)", grados); 





Cuando el usuario escriba un dato en una de las cajas de texto, seguramente 
que, a continuación, pulsará la tecla Entrar en vez de la tecla Tab. Para capturar 
esta pulsación vamos a añadir el controlador del evento KeyPress y será este con- 
trolador el que sitúe el foco en la otra caja, como si el usuario hubiera pulsado la 
tecla Tab o hubiera hecho clic en la otra caja. 


private void Cajalexto_KeyPress(object sender, KeyPressEventArgs e) 
( 
TextBox objlTextBox = (TextBox)sender; 
if (e.KeyChar == Convert.ToChar(13)) 
( 
// Se pulsó la tecla Entrar 
e.Handled = true; 
// Cambiar el foco a otro control 
if (objTextBox == ctGradosC) 
( 
ctGradosF.Focus(); 
) 
else 
( 
ctGradosC.Focus(); 
) 


Habrá observado que mientras que los datos del control que tiene el foco no 
sean válidos, no se puede cerrar el formulario por los métodos utilizados normal- 
mente. Si desea permitir que esta operación se realice (cerrar un formulario aun- 
que contenga datos no válidos), puede crear un controlador para el evento Form- 
Closing del formulario y asignar a la propiedad Cancel del parámetro e de tipo 
FormClosingEventArgs el valor false. Esto obliga al formulario a cerrarse. En 
este caso, la información de los controles que no se haya guardado se perderá. 


100 ENCICLOPEDIA DE MICROSOFT VISUAL CH 


Nota: los formularios modales no validan el contenido de los controles cuan- 
do se cierran. 


Expresiones regulares 
Las expresiones regulares proporcionan un método eficaz y flexible para: 


e Analizar rápidamente grandes cantidades de texto. 

e Buscar modelos de caracteres específicos. 

e Validar un texto contra un modelo predefinido (por ejemplo, una dirección de 
correo electrónico). 

e Extraer, editar, reemplazar o eliminar subcadenas de texto. 

e Agregar las cadenas extraídas a una colección. 


Veamos a continuación una pequeña introducción a base de ejemplos. Estos 
ejemplos y otros los puede practicar si descarga de Internet alguna utilidad para 
trabajar con expresiones regulares, como, por ejemplo, la aplicación Expresso. 


Ejemplos de expresiones regulares 


Supongamos que necesitamos buscar una palabra en un documento; por ejemplo, 
probar. La búsqueda podríamos realizarla con la expresión regular: 


probar 


Esta expresión, ignorando las mayúsculas, podrá coincidir con “probar” o 
“PROBAR”, pero también con “comprobar”. Para evitar esta última coincidencia 
podemos utilizar esta otra expresión regular: 


YbprobarXb 


El código “Vb” significa: coincidir con el primer o último carácter en una pa- 
labra. Esta expresión coincidirá solo con “probar”, con cualquier combinación de 
mayúsculas o minúsculas. 


Supongamos ahora que deseamos buscar la palabra “probar” seguida (no ne- 
cesariamente justo después) de la palabra “aplicación”. Ahora, la expresión regu- 
lar puede ser esta: 


YbprobarYb.*AbaplicaciónAb 

El punto “.” es un carácter especial que significa: coincidir con cualquier ca- 
rácter excepto nueva línea (NL), y el “*” significa: repetir el término anterior tan- 
tas veces como sea necesario para que se dé la coincidencia (cero o más veces). 


CAPÍTULO 4: INTRODUCCIÓN A WINDOWS FORMS 101 


Posibles resultados podrían ser: “Probar la aplicación” o “Probar después la apli- 
cación”. 


Si lo que deseamos es buscar palabras que empiecen por “pro”, podríamos 
utilizar la expresión regular: 


Vbprolw*Xb 
El código “\w” significa: coincidir con cualquier carácter alfanumérico. 


Para buscar cadenas de uno o más dígitos emplearíamos la expresión: 


\d+ 


El código “\d” significa: coincidir con cualquier digito, y el “+” significa: re- 
petir el término anterior tantas veces como sea necesario para que se dé la coinci- 
dencia (una o más veces). El “+” es similar al “*”, excepto que “+” requiere al 
menos una repetición. 


Supongamos ahora que deseamos identificar números de la forma “666 555 
444”, o bien “666555444”. Para esto podemos utilizar alguna de las expresiones 
regulares siguientes: 


\b\d\d\d\s?\d\d\d\s?\d\d\d\b 
VbYd(3)As?Ad[3JAS?Ad(3JAD 
b(1d(3)1s?)(3JAb 


El código “Ad” significa: coincidir con cualquier dígito, el código As” signifi- 
ca: coincidir con un espacio en blanco (espacio, tab y NL), el “?” significa que se 
puede repetir el término anterior cero o una vez, y el “(3)” significa: repetir el 
término anterior exactamente tres veces. Los paréntesis, (d(3j1s?), pueden ser 
utilizados para delimitar una subexpresión para permitir la repetición u otras ope- 
raciones especiales. 


En cambio, si quisiéramos validar una entrada en la que todo el texto debe 
coincidir con un patrón, por ejemplo con (\d{3}\s?){3}, utilizaríamos la expresión 
regular: 


^(\d{3}\s?){3}$ 
Los caracteres “^” y “$” indican buscar algo que debe comenzar al principio 
de un texto y/o finalizar al final del texto (una línea o un string). Esto nos permi- 
tirá validar, por ejemplo, una caja de texto. 
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Supongamos ahora que deseamos identificar números de la forma “666 555 
444” o bien “666555444” con un prefijo formado por el “+” o su equivalente “00” 
seguido de uno a tres digitos; por ejemplo: “+1”, “+34”, “0034”, “+586”. Para es- 
to podemos utilizar la expresión regular siguiente: 


aCA+po0)d11,3)1s?)?(1d(3)1s?)(3)$ 


Un carácter barra invertida (1) en una expresión regular indica que el carácter 
que le sigue es un carácter especial (1s: carácter especial s) o que se debe interpre- 
tar literalmente (W+: literal +). Y el símbolo “|” permite separar distintas alternati- 
vas de las cuales se aplicará la que coincida. 


Supongamos ahora que deseamos identificar direcciones IP de la forma 
“*192.128.9.34”. Para esto podemos utilizar la expresión regular siguiente: 


(dd(1,3)1.)(3)1d(1,3) 


La primera parte de esta expresión, (d(1,3)1.), busca de uno a tres dígitos se- 
guidos de un punto; esta parte se repite tres veces, {3}; y la última parte busca de 
uno a tres dígitos. Una expresión regular equivalente sería esta otra: 


Og Ti LS 3IA. 1139. 10=9T11, 37 


Los corchetes, [juego de caracteres], definen una clase de caracteres, la cual 
coincidirá con cualquier carácter del juego de caracteres definido. Lo opuesto se 
expresa así: [juego de caracteres]; en este caso, la coincidencia será con cual- 
quier carácter individual que no esté en el juego de caracteres. También se pueden 
expresar intervalos de caracteres así: [primero-último|; en este caso, la coinciden- 
cia será con cualquier carácter individual en el intervalo de primero a último. 


Continuando con el ejemplo anterior, sabemos que las partes que componen 
una IP son valores entre 0 y 255, limitación que no es contemplada por la expre- 
sión regular expuesta. Para garantizar que las distintas partes que componen una 
IP estén dentro del rango permitido, utilizaremos esta otra expresión: 


((2[0-4]\d|25[0-5]|[01]?\d\d?)\.){3}(2[0-4]\d|25[0-5]|[01]?\d\d?) 


Un ejemplo más. En este caso vamos a escribir una expresión regular que nos 
permita validar la dirección de un correo-e. Esta expresión podría ser así: 


^,+@.+\.[a-z]{2,3}$ 


Observamos que cualquier coincidencia tendrá, inicialmente, uno o más ca- 
racteres, después el símbolo (W, después otra vez uno o más caracteres y finalmen- 
te un punto seguido de dos a tres letras. 
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Todo lo expuesto no es más que una pequeña introducción a las expresiones 
regulares. Queda mucho más por estudiar, pero este tema se sale fuera de los obje- 
tivos de este libro. No obstante, para abundar en este tema, siempre puede recurrir 
a la ayuda proporcionada por MSDN. 


El motor de expresiones regulares 


Según lo expuesto, las expresiones regulares proporcionan un método eficaz y 
flexible para validar un texto con el fin de asegurar que se corresponde con un 
modelo predefinido. Por ello, .Net Framework proporciona un motor de expresio- 
nes regulares representado por la clase Regex. Este motor es el encargado de ana- 
lizar y compilar una expresión regular y de realizar las operaciones anteriormente 
descritas. Para ello, esta clase proporciona varios métodos entre los cuales desta- 
camos los siguientes: 


e  IsMatch. Este método devuelve true si el modelo de expresión regular espe- 
cificado da lugar a alguna coincidencia en un texto determinado. Por ejemplo: 


bool coincide = Regex.IsMatch(objTextBox.Text, patron); 


e Match. Este método devuelve la primera coincidencia de una expresión regu- 
lar en un texto determinado. Por ejemplo: 


Match c = Regex.Matchí(texto, patrón, Regex0ptions.IgnoreCase); 
if (c.Suecess) // si hubo una coincidencia... 
Console.WritelLine("Encontrado *([0)” en la posición (1).", 
c.Value, c.Index); 


e Matches. Este método devuelve una colección con todas las coincidencias de 
una expresión regular en un texto determinado. Por ejemplo: 


foreach (Match c in Regex.Matches(texto, patrón, 
Regex0ptions.Ignorelase)) 


Console.WritelLine("Encontrado *([0)” en la posición (1).", 
c.Value, c.Index); 


e Replace. Este método reemplaza todas las cadenas que coinciden con una ex- 
presión regular especificada, por una cadena de reemplazo determinada. 


string resultado = Regex.Replace(texto, patrón, cadReemplazo); 


Aplicando la teoría expuesta, vamos a escribir una expresión regular que nos 
permita validar el contenido de las cajas de texto de la aplicación Windows Forms 
anterior (Conver). Esta expresión podría ser así: 
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A[+-3?[0-9]+,?[0-9]%*$ 


Observamos que inicialmente puede haber un signo + o — (cero o una vez), 
después puede haber uno o más dígitos, después una coma (cero o una vez) y fi- 
nalmente cero o más dígitos decimales. 


A continuación, modificamos el método CajaTexto_Validating para que, uti- 
lizando el motor de expresiones regulares Regex, aplique esa expresión regular 
para validar el texto de las cajas de texto del formulario: 


private void Cajalexto_Validating(object sender, CancelEventArgs e) 
( 
TextBox objlTextBox = (TextBox)sender; 
string patron = ""[+-]?[0-9]+,?[0-9]*$"; 
if (Regex.IsMatch(objlextBox.Text, patron)) 
( 





datolajalexto = Convert.ToDouble(objlTextBox.Text):; 
) 
else 
( 
e.Cancel = true; 
objTextBox.SelectAl1(); 
ProveedorDeError.SetError(objlextBox, "Tiene que ser numérico"); 
) 
) 


MaskedTextBox 


La clase MaskedTextBox, derivada de TextBoxBase, es un control TextBox me- 
jorado que soporta una sintaxis declarativa para aceptar o rechazar una entrada del 
usuario. Utilizando la propiedad Mask se puede especificar la siguiente entrada 
sin escribir una validación personalizada: 


e El número de caracteres requeridos. 

e Caracteres opcionales. 

e El tipo de entrada esperada en una posición determinada; por ejemplo, un dí- 
gito, un carácter alfabético o un carácter alfanumérico. 

e Caracteres que componen la máscara o caracteres que deberían aparecer di- 
rectamente en el control; por ejemplo, el guión (-) en una fecha o el carácter 
que especifica la moneda utilizada. 


Los caracteres utilizados para componer la máscara que almacenaremos en la 
propiedad Mask son los siguientes: 


0 — Dígito entre 0 y 9; entrada requerida. 
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9 — Dígito o espacio; entrada opcional. 

# — Dígito o espacio; entrada opcional. Permite los signos + y —. 
L — Letra; entrada requerida. Restringe la entrada a a-z y A-Z. 

? — Letra; entrada opcional. Restringe la entrada a a-z y A-Z. 


& — Carácter; entrada requerida. Si la propiedad AsciiOnly se pone a true, este 
elemento se comporta igual que L. 


C — Carácter; entrada opcional. Cualquier carácter que no sea de control. Si la 
propiedad AsciiOnly se pone a true, este elemento se comporta igual que ?. 


A — Alfanumérico; entrada requerida. Si la propiedad AsciiOnly se pone a true, 
solo se aceptarán las letras a-z y A-Z. 


a — Alfanumérico; entrada opcional. Si la propiedad AsciiOnly se pone a true, so- 
lo se aceptarán las letras a-z y A-Z. 


. — Marcador de posición decimal. El carácter que se mostrará (punto o coma de- 
cimal) dependerá de la cultura actual. 


, — Separador de millares. El carácter que se mostrará (punto o coma de millares) 
dependerá de la cultura actual. 


: — Separador de horas, minutos y segundos. 
/ — Separador del día, mes y año. 
$ — Símbolo monetario. El carácter que se mostrará dependerá de la cultura actual. 


< — Cambio a minúsculas. Convierte todos los caracteres que le siguen a minúscu- 
las. 


> — Cambio a mayúsculas. Convierte todos los caracteres que le siguen a mayús- 
culas. 


| — Cancela el cambio a minúsculas o a mayúsculas previo. 


\— Escape. Libera a un carácter de Mask de su función, haciendo que se comporte 
como un literal. Por ejemplo, A” es el literal “”. 


Todos los caracteres — Literales de cadena. Todos los demás símbolos se mues- 
tran como literales; es decir, como ellos mismos. 


A continuación se muestran algunos ejemplos: 


H-2??? -1HHHF Fecha de la forma: 20-may-2016 
HEIHE 72? Hora de la forma: 12:15 PM 
00->L<LL-0000 Una fecha: día, mes abreviado y año (20-May-2016) 


La propiedad PromptChar especifica el carácter utilizado para rellenar las 
posiciones donde hay que introducir un carácter (por omisión es “_”). La propie- 
dad Text almacena la entrada del usuario y, dependiendo del valor de la propie- 
dad TextMaskFormat, los literales de cadena, los caracteres de solicitud de datos 
o ambos. Un valor IncludeLiterals (valor predeterminado), perteneciente a la 
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enumeración MaskFormat, para TextMaskFormat indica que Text incluirá los 
literales de cadena de la máscara, como, por ejemplo, el guión (-) en una fecha, 
IncludePrompt indica que Text incluirá el carácter PromptChar de las posicio- 
nes no rellenadas e IncludePromptAndLiterals indica que Text incluirá ambos. 
Si ResetOnPrompt vale true, el carácter PromptChar no formará parte de la en- 
trada. 


Se puede poner la propiedad BeepOnError a true para avisar al usuario de 


que el carácter introducido no es válido. También se puede utilizar el evento Mask- 
InputRejected para realizar nuestro propio tratamiento del error. 


EJERCICIOS RESUELTOS 


Realizar el diseño de una calculadora como la de la figura siguiente. 


Diseño de una calculadora 


Antes de crear una aplicación, es aconsejable que respondamos a algunas pregun- 
tas como las siguientes: 


e ¿Qué objetos forman la interfaz? 
e ¿Qué eventos hacen que la interfaz responda? 
e ¿Cuáles son los pasos a seguir para un desarrollo ordenado? 





r 
2 Formi 


















































Objetos 
La calculadora incluye los siguientes objetos: 


e Un formulario que permita implementar nuestra interfaz. 
e Una etiqueta (pantalla de la calculadora). 
e Diecinueve botones de órdenes distribuidos de la forma siguiente: 
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©  Dígitos del 0 al 9. 

© Coma decimal. 

© Operaciones +,—, x, /, = y %. 

© Operaciones de borrar todo (C) y borrar última entrada (CE). 
Eventos 


Haciendo clic sobre las teclas de los dígitos visualizaremos un número en la pan- 
talla que puede contener una coma decimal. La entrada de un número finalizará al 
hacer clic sobre una de las teclas de operación. Por lo tanto, el evento al que tiene 
que responder cada uno de los botones es un clic del ratón (o su equivalente: se- 
leccionar el botón con Tab y pulsar la barra espaciadora o la tecla Entrar). 
Pasos a seguir durante el desarrollo 


1. Crear el esqueleto para una nueva aplicación que utilice un formulario de tipo 
Form como ventana principal. 


2. Añadir los componentes necesarios al formulario. 
3. Definir las propiedades de los componentes. 

4. Escribir el código para cada uno de los objetos. 
5. Guardar la aplicación. 


6. Crear un fichero ejecutable. 


Diseño de la ventana y de los controles 


Conocidos los objetos y los eventos, procedemos a dibujar la interfaz. Para ello, 
creamos el esqueleto para una nueva aplicación, denominada Calculadora, que 
utilice un formulario como ventana principal, y le asignamos el título “Calculado- 
ra”. El código completo puede obtenerlo del CD en la carpeta Cap04 Resueltos. 


El paso siguiente es dibujar sobre el formulario los componentes con las pro- 
piedades que se especifican en la tabla siguiente: 
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Etiqueta. 
Pantalla 


(Name) 
AutoSize 
BorderStyle 
BackColor 
Font 
TextAlign 
Text 


etPantalla 

false 

Fixed3D 

[255,255,192] 

MS Sans Serif, Bold, 14,25 
MiddleRight 


> 


T 
Botón de pulsación ame) btMas 
Tecla + T + 


Botón de pulsación ame) btPor 
Tecla x T x 


( 

( 
Botón de pulsación (Name) btMenos 
Tecla — T — 

( 

( 


Tecla = T = 
Coma decimal T ? 
Tanto por ciento T % 


Botón de pulsación 
Puesta a cero total 
Botón de pulsación. 
Puesta a cero última 
entrada 


0 
Botón de pulsación ame) btDigiton (n: 0 a 9) 
Teclas 0 a 9 0, 1,....9 





T 
(Name) 
Text 


A N 
ext 

ión. N 
ext 

ión. N 
ext 

ión. N 
ext 

Tecla Text / 

ión. N 
ext 

ión. N 
ext 

ión. N 
ext 

E N 
ext 








btIniciar 

C 
btBorrarEntrada 
CE 


Para referirnos en el código a cada uno de los componentes hay que asignarles 
un identificador. En la tabla anterior, la propiedad (Name) de cada componente 
indica cuál es este identificador, que será definido como una variable miembro de 
la clase Forml1, del proyecto Calculadora, que presentamos de forma abreviada a 
continuación. Un objeto de esta clase dará lugar a la interfaz gráfica cuyo diseño 
hemos presentado anteriormente: 


partial class Forml 
( 


private void InitializeComponent() 


( 


btBorrarEntrada = 


new System.Windows.Forms.Button(); 
btDigito9 = new System.Windows.Forms.Button(); 
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btDigito8 = new System.Windows.Forms.Button():; 

btDigito/ = new System.Windows.Forms.Button():; 

etPantalla = new System.Windows.Forms.Label(); 

// 

etPantalla.Name = "etPantalla"; 

etPantalla.Size = new System.Drawing.Size(222, 27); 

etPantalla.Tablndex = 39; 

etPantalla.Text = "0,"; 

etPantalla.TextAlign = 
System.Drawing.ContentAlignment.MiddleRight; 

// 


) 


private System.Windows.Forms.Button btBorrarEntrada; 
private System.Windows.Forms.Button btDigito9; 
private System.Windows.Forms.Button btDigito8; 
private System.Windows.Forms.Button btDigito7; 
private System.Windows.Forms.Label etPantalla; 

// 


Los botones, las etiquetas y las cajas de texto permiten alinear el texto hori- 
zontal y verticalmente. Para establecer la alineación utilizaremos la propiedad 
TextAlign a la que asignaremos un valor del tipo enumerado ContentAlignment. 
Los valores más comunes para este parámetro son MiddleCenter, MiddleLeft y 
MiddleRight. 


Así mismo, los objetos como Label (etiqueta) y TextBox (caja de texto), res- 
pecto a su manipulación por un usuario, pueden ser de solo lectura, caso de la eti- 
queta, o de lectura y escritura, como sucede con la caja de texto. Esta propiedad 
en el caso de la etiqueta es invariable, pero, en el caso de la caja de texto, es modi- 
ficable por medio de la propiedad ReadOnly; cuando su valor es true, indica que 
el componente puede ser escrito por el usuario y cuando su valor es false, el usua- 
rio no puede escribir sobre él. Esto quiere decir que para la pantalla también po- 
dríamos haber utilizado una caja de texto de solo lectura. 


Establecer una fuente 


Para utilizar una determinada fuente, hay que construir un objeto Font con las ca- 
racterísticas deseadas. Después, para establecer esa fuente en un control de texto, 
utilizaremos la propiedad Font. Por ejemplo, el código siguiente es el que añadió 
el asistente de Visual Studio cuando modificamos la fuente del control etPantalla: 


etPantalla.Font = new System.Drawing.Font( 
"Microsoft Sans Serif", 
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14.25F, 
System.Drawing.FontStyle.Regular, 
System.Drawing.GraphicsUnit.Point, 
((byte)(0))); 


El constructor Font toma varios parámetros: nombre de la fuente, tamaño, es- 
tilo, etc. A su vez, el estilo puede ser Regular, Bold o Italic, entre otros. 


Color 


Todo componente tiene un color de fondo y un color de primer plano. El color de 
fondo se utiliza para rellenar los interiores de los componentes y el color de pri- 
mer plano, para dibujar sobre el color de fondo (por ejemplo, el color utilizado pa- 
ra pintar el texto sobre un componente). 


Para establecer el color de fondo, utilizaremos la propiedad BackColor del 
control, y para establecer el color de primer plano, la propiedad ForeColor. Am- 
bas propiedades toman un valor que se corresponde con un objeto de la clase Co- 
lor. Por ejemplo, el código siguiente es el que añadió el asistente de Visual Studio 
cuando modificamos el color de fondo del control etPantalla: 


etPantalla.BackColor = System.Drawing.Color.FromArgb( 
(Gnt)(((byte)(255)))), 
((int)(((byte)(255)))), 
((Cint)(((byte)(192))))); 


Se puede observar que el método FromArgb utilizado de la clase Color tiene 
tres parámetros que se corresponden con tres valores enteros entre 0 y 255 que es- 
pecifican el nivel de color rojo, verde y azul, respectivamente. El objeto Color 
construido, devuelto por FromArgb, representa el color RGB (Red, Green y 
Blue) especificado. 


A modo de ejemplo, la siguiente tabla muestra los valores para algunos colo- 
res estándar: 


Color nivel de rojo nivel de verde nivel de azul 
Negro 0 0 0 

Azul 0 0 255 

Verde 0 255 0 
Aguamarina 0 255 255 

Rojo 255 0 0 

Fucsia 255 0 255 
Amarillo 255 255 0 


Blanco 255 255 255 
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Escribir el código 


Una vez que se ha puesto nombre a todos los controles y se han especificado el 
resto de las propiedades de interés, el paso siguiente es unir el código correspon- 
diente a cada uno de los controles para que cada uno de ellos cumpla su función. 
En este proceso deberemos tener en cuenta si hay controles que tienen un compor- 
tamiento similar y, por lo tanto, pueden compartir el mismo controlador. En este 
sentido, en la calculadora hay 10 teclas cuya finalidad es visualizar un dígito en la 
pantalla, esto es, su función es la misma, lo que quiere decir que pueden compartir 
el mismo controlador. Igualmente sucede con el grupo de teclas +, —, x, /, =. El 
resto de las teclas actúan independientemente. 


¿Por dónde se empieza? En una programación conducida por eventos se pue- 
de empezar por cualquier control. 


Por ejemplo, empiece con las teclas correspondientes a los dígitos 0 a 9, y 
pregúntese: ¿qué tiene que suceder cuando se haga clic sobre un dígito? Cuando 
esto suceda se espera que el dígito aparezca en la pantalla de la calculadora. Esto 
se consigue escribiendo un procedimiento que responda al evento clic y asigne el 
título de la tecla (0, 1...) a la etiqueta que representa la pantalla. Para crear un pro- 
cedimiento como este, hay que realizar los pasos siguientes: 


1. Asignar un controlador de eventos a cada uno de los botones 0 a 9. Para ello, 
diríjase a la ventana de diseño, seleccione los botones 0 a 9, diríjase a la ven- 
tana de propiedades, seleccione el evento Click y asigne al controlador el 
nombre btDigito Click: 


// En InitializeComponent 

btDigito0.Click += new EventHandler(btDigito_Click); 
LA a 

btDigito9.Click += new EventHandler(btDigito_Click); 
1/ 


private void btDigito_Click(object sender, EventArgs e) 
( 


) 


2. El código anterior indica que un clic en cualquier botón 0 a 9 hace que ese bo- 
tón genere un evento Click. Como respuesta a este evento se ejecutará el mé- 
todo btDigito Click. Este método, que será compartido por todas las teclas 
btDigito0 a btDigito9, tiene que asignar el título de la tecla pulsada (0, 1...) a 
la etiqueta que representa la pantalla. Según esto, añada el siguiente código al 
método btDigito Click de la clase Forml: 
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private void btDigito_Click(object sender, EventArgs e) 
( 

Button objButton = (Button)sender; 

etPantalla.Text = objButton.Text; 
) 


El método btDigito Click, tal cual se ha escrito, asigna solo un dígito a la 
pantalla de la calculadora. Para asignar un dígito tras otro, hay que modificar el 
código de forma que cada nuevo dígito tecleado sea añadido a los ya existentes en 
la pantalla. Esto se consigue modificando el método anterior así: 


private void btDigito_Click(object sender, EventArgs e) 
( 

Button objButton = (Button)sender; 

etPantalla.Text += objButton.Text:; 
) 


Guarde la aplicación y ejecútela. Observará que ahora todos los números te- 
cleados empiezan por “0,”. Esto indica que la pantalla debe ser iniciada cada vez 
que el usuario vaya a introducir un nuevo número. Este caso se da al principio y 
después de teclear un operador. Para detectarlo, añadiremos una nueva variable 
miembro a la clase Form1, denominada ultimaEntrada, que tendrá el valor DIGI- 
TO si lo último tecleado ha sido un dígito, y otro valor en otro caso. Inicialmente 
tiene un valor NINGUNA. 


if (ultimaEntrada != Entrada.DIGITO) 
etPantalla.Text = ""; 


El valor DIGITO y otros más que necesitaremos serán constantes de un tipo 
enumerado Entrada, como veremos a continuación. 


Otro detalle a tener presente es que los ceros iniciales no son significativos, 
por lo que no se tendrán en cuenta. Esto es: 


if (objButton.Text == "0") return; 


Cuando se inicia la aplicación, se ejecuta el constructor Form]. Declare la va- 
riable ultimaEntrada como miembro de la clase Form] e iníciela en el constructor 
de la clase. El constructor se localiza en la definición parcial de la clase almace- 
nada en el fichero Form1.cs. Con las modificaciones introducidas, el código que- 
da como sigue: 


public partial class Forml : Form 
( 

private enum Entrada 

( 


) 
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NINGUNA, 
DIGITO, 
OPERADOR, 
CE 


private Entrada ultimaEntrada; 


public Forml() 


( 


) 


InitializeComponent(); 
ultimaEntrada = Entrada.NINGUNA; 





private void btDigito_Click(object sender, EventArgs e) 


( 


Button objButton = (Button)sender; 


if (ultimaEntrada != Entrada.DIGITO) 
{ 
if (objButton.Text == "0") return; 
etrantol la Tema = THs 
ultimaEntrada = Entrada.DIGITO; 








} 
etPantalla.Text += objButton.Text; 





Para añadir decimales a un número, se pulsa la tecla de la coma decimal. An- 


tes de escribir el código para esta tecla, analicemos los casos que se pueden dar: 


1. 


El usuario introduce un número que no tiene parte entera y empieza la entrada 
pulsando la tecla coma. 


El número tiene parte entera. 


No aceptar una segunda coma decimal. Para detectar este caso, introducire- 
mos una nueva variable, denominada comaDecimal, que tendrá el valor true 
si el número ya tiene una coma decimal, o un valor false si no la tiene. Defina 
esta variable análogamente a como lo ha hecho con ultimaEntrada. 


Añada a la declaración de la clase Forml: 
private bool comaDecimal:; 


Añada a la definición del constructor de Forml: 


comaDecimal = false; 
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De acuerdo con lo expuesto, asocie un controlador de eventos btComa- 
Dec_Click con la tecla coma decimal y escriba el código que responda al evento 
Click como se indica a continuación: 


private void btComaDec_Click(System.Object sender, System.EventArgs e) 
( 

if (ultimaEntrada != Entrada.DIGITO) 

( 
etPantalla.Text = "0,"; 
ultimaEntrada = Entrada.DIGITO; 

) 

else if (comaDecimal == false) 
etPantalla.Text = etPantalla.Text + ","; 











comaDecimal = true; 


Una vez que el usuario ha tecleado un número, lo lógico es que pulse a conti- 
nuación la tecla correspondiente a la operación a realizar. Esto es, el usuario hará 
clic sobre una de las teclas +, —, x, / o =. Se ejecutará el controlador para estos bo- 
tones, que será el método btOperacion Click de la clase Form1. En este instante, 
la calculadora tiene que recordar el operador introducido, para lo que utilizará la 
variable operador de tipo char: 


// Texto del botón pulsado 
string textoBoton = objButton.Text; 
operador = textoBoton[0]; // carácter de la posición O 


Defina la variable operador en la declaración de la clase Form1 análogamente 
a como lo ha hecho con comaDecimal e iníciela a O en el constructor de la clase: 


private char operador; 
operador = *X0*; // Iniciar la variable a nulo 


A continuación, el usuario introducirá otro número. Para presentar en pantalla 
el nuevo número, esta tiene que ser iniciada. Para enterarnos de este detalle, des- 
pués de introducir un operador, haremos que la variable ultimaEntrada tome el 
valor OPERADOR. 


ultimaEntrada = Entrada.OPERADOR; 


Por otra parte, si la calculadora, además del operador, no recuerda el primer 
operando, este se perderá cuando se inicie la pantalla para introducir el segundo 
operando: 


operandol = Double.Parse(etPantalla.Text); 
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Nota: en lugar de Parse se podría utilizar TryParse; este método, a diferencia 
del anterior, no lanzaría una excepción si la conversión no fuera posible. 


S1 introdujo una coma decimal en el primer operando, la variable coma- 
Decimal vale true. Por lo tanto, para permitir una coma decimal en el segundo 
operando, hay que volver a poner, en el método btDigito_Click, la variable coma- 
Decimal a valor false: 


private void btDigito_Click(object sender, EventArgs e) 
( 
Button objButton = (Button)sender; 

if (ultimaEntrada != Entrada.DIGITO) 
( 
if (objButton.Text == "0") return; 
etPantalla.Text = ""; 
ultimaEntrada = Entrada.DIGITO; 
comaDecimal = false; 
) 











etPantalla.Text += objButton.Text; 
) 


Recopilando lo expuesto hasta ahora y pensando un poco más allá, el proceso 
total se puede resumir en los siguientes puntos: 


1. Primero, un usuario introduce un operando. 


2. A continuación introduce un operador. La calculadora recuerda el operando y 
el operador. 


3. Después introduce un segundo operando. 


4. Y cuando introduce otro operador, la calculadora: 
e Recuerda el segundo operando. 


e Visualiza en la pantalla el resultado producido por el primer operador so- 
bre los dos operandos. 


e Recuerda el resultado, como si se hubiera introducido un operando, y el úl- 
timo operador. 


5. Si se introduce un operador a continuación de otro, se recuerda el último. 


6. Con respecto a una operación cualquiera, la calculadora debe saber cuándo se 
introduce el operando primero y cuándo se introduce el segundo, para alma- 
cenarlos en lugares diferentes y para saber si ya tiene que realizar la opera- 
ción. Para esto, utilizaremos una variable numOperandos, que valdrá 1 cuan- 
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do se haya introducido el operando primero, y 2 cuando se haya introducido 
el segundo. 


7. El resultado de una operación queda disponible como operando primero para 
una siguiente operación. 


Para escribir el método btOperacion Click, añada un controlador de eventos 
Click para los botones +, —, x, / 0 =. 


private void btOperacion_Click(object sender, EventArgs e) 


( 
) 


Declare las variables numOperandos, operandol y operando2 como miem- 
bros de la clase Calculadora e inicielas en su constructor: 


public partial class Forml : Form 
( 
11 


private Entrada ultimaEntrada; 
private bool comaDecimal'; 
private char operador; 

private byte numOperandos; 
private double operandol; 
private double operando2; 








public Forml() 

( 
InitializeComponent(); 
ultimaEntrada = Entrada.NINGUNA; 
comaDecimal = false; 





operador = *X0”; 
numOperandos = 0; 
operandol = 0; 


operando2 = 0; 


1/ 


Escriba el código siguiente correspondiente al método btOperacion_ Click, re- 
sultado del análisis que acabamos de hacer: 


private void btO0peracion_Click(object sender, EventArgs e) 
( 
// Obtener el id del botón que generó el evento 


[v0] 


/ 
S 


MEEA 


} 
o 
u 


a la 
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tton objButton = (Button)sender; 
/ Obtener el texto del botón pulsado 
tring textoBoton = objButton.Text; 


(ultimaEntrada Entrada.DIGITO) 


mOperandos += 1; 


25 


(numOperandos == 1) 
perandol = doubl 
e if (numOperandos == 2) 


o 





n 








perando2 = doubl 


o 


switch (operador) 
( 
case +”: 
operando 
reak; 


YN 


+= operando?2; 


(9) 
o 
(9) 


perandol -= 0 02; 


reak; 

y? 
perando 
reak; 
OEE 
perandol /= operando2; 
reak; 


.»_> 


perand 


0) 
o 
(9) 





x= operando; 


O 
o 
(9) 








O 
o 
(9) 

















0onNTODNOTONOTOMN Y 


perando 02; 


DreaKk; 


= operand 








) 

// Visualizar el 
etPantalla.Text = 
num0Operandos = 1; 


resultado 


perador = 


ltimaEntrada = Entrada.OPERADOR; 


e.Parse(etPantalla. 


Text); 





e.Parse(etPantalla. 


Text); 


operandol.ToString(); 


textoBoton[0]; // carácter de la posición 0 


La siguiente tecla que vamos a programar es la del tanto por ciento. Para ello, 
piense primero en cómo trabaja esta tecla. Supongamos que ha llegado a la con- 
clusión de que la forma general de actuar es: 


Operando_] Operador Operando_2 % 


Por ejemplo, si se teclea 1000 + 5 %, se visualiza 1050. 


En el caso de pulsar repetidas veces la tecla %, la calculadora solo responderá 


primera. 
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En función de lo expuesto, asocie un controlador de eventos btTantoPorCien- 
to_Click con la tecla tanto por ciento y escriba el código que responda al evento 
Click como se indica a continuación: 


private void btlantoPorCiento_Click(object sender, EventArgs e) 
( 
double resultado; 
if (ultimaEntrada == Entrada.DIGITO) 
( 
resultado = operandol * double.Parse(etPantalla.Text) / 100; 
// Visualizar el resultado 
etPantalla.Text = resultado.ToString(); 
// Simular que se ha hecho clic en "=" 
btIgual.PerformClick(); 
// Enfocar la tecla % 
btTantoPorCiento.Focus(); 








La sentencia resultado = ..., calcula el tanto por ciento especificado por et- 
Pantalla de la cantidad especificada por operandol. Por ejemplo, si se teclea 
1000 + 5 %, la operación anterior produce un resultado de 50. 


El resultado se lleva a la pantalla como si el segundo operando de la opera- 
ción especificada (en el ejemplo +) se hubiera introducido. Para que se realice au- 
tomáticamente esta operación, de acuerdo con el ejemplo 1000 + 50, se envía al 
objeto btIgual (tecla “=”) el mensaje PerformClick; el resultado de la ejecución 
de este método para el objeto bt/gual equivale a haber hecho clic en la tecla “=”. 


Cuando se pulsa la tecla C es porque se quiere iniciar la calculadora, esto es, 
como si la acabáramos de encender. Entonces, lo que tiene que suceder es que en 
la pantalla aparezca “0,” y que las variables de la clase Form] especificadas a 
continuación sean iniciadas. Para ello, asocie un controlador de eventos bt/ni- 
ciar_Click con la tecla C y escriba el código que responda al evento clic como se 
indica a continuación: 


private void btIniciar_Click(object sender, EventArgs e) 
( 
etPantalla.Text = "0,"; 
ultimaEntrada = Entrada.NINGUNA; 
comaDecimal = false; 

operador = *10”; 

numOperandos = 0; 

operando 
operando2 








=; 
=; 
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Cuando pulsamos la tecla CE, lo que queremos hacer es borrar el último dato 
tecleado (dato actual de la pantalla), porque nos hemos equivocado y tenemos que 
repetirlo. En este caso, solo hay que iniciar la pantalla a cero y poner las variables 
afectadas al valor correspondiente en ese instante. Para ello, asocie un controlador 
de eventos btBorrarEntrada Click con la tecla CE y escriba el código que res- 
ponda al evento clic como se indica a continuación: 


private void btBorrarEntrada_Click(object sender, EventArgs e) 
( 

etPantalla.Text = "0,"; 

ultimaEntrada = Entrada.CE; 

comaDecimal = false; 


Para terminar, vamos a fijarnos en un último detalle. Cuando iniciamos la cal- 
culadora, no es posible realizar una operación como, por ejemplo, -3 x 5 (no 
piense en operaciones como 5 x —3, ya que, como es el último operador el que se 
tiene en cuenta, lo que se realiza es 5 — 3). Este caso se da cuando, sin haber te- 
cleado operando alguno, tecleamos un signo “—” con la finalidad de que el primer 
operando sea negativo. Para dar solución a este caso particular, añada el siguiente 
código al método btOperacion Click: 


private void btOperacion_Click(object sender, EventArgs e) 

( 
// Obtener el id del botón que generó el evento 

Button objButton = (Button)sender; 

// Obtener el texto del botón pulsado 

string textoBoton = objButton.Text; 

ir (numOperandos == 0) 44 (textoBoton[01 == =°) 

ultimaEntrada = Entrada.DIGITO; 














if (ultimaEntrada == Entrada.DIGITO) 
numOperandos += 1; 


1! 
) 


EJERCICIOS PROPUESTOS 


1. Modifique la aplicación Conver3, desarrollada anteriormente en este capítulo, 
para que presente una interfaz gráfica similar a la mostrada por la figura siguiente. 
En ella puede observar que se han añadido dos etiquetas: una que contiene el lite- 
ral “Fecha” y otra que muestra la fecha actual. También se han añadido dos boto- 
nes “+1”. El botón “+1” que está a la derecha de la caja de texto que muestra los 
grados centígrados incrementa este valor en una unidad y, simultáneamente, mo- 
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difica la caja de texto grados Fahrenheit para que muestre el valor equivalente. Un 
comportamiento análogo tiene el botón “+1” que está a la derecha de la caja de 
texto grados Fahrenheit. 





Grados centígrados: 








Grados Fahrenhett: 





Pruebe a utilizar el control MaskedTextBox. 


2. Una vez que haya ejecutado y comprendido la aplicación Calculadora realizada 
anteriormente en este mismo capítulo, como ejercicio intente añadir algunas fun- 
ciones más a la calculadora. Por ejemplo: 


1. Añadir las teclas de memoria: 
e Sumar al contenido de la memoria (M+). 
e Restar del contenido de la memoria (M-). 
e Leer el contenido de la memoria (MR). 


2. Añadir las funciones matemáticas más usuales. 


3. Permitir utilizar, además del ratón, el teclado numérico para introducir datos. 

































































CAPÍTULO 5 


O F.J.Ceballos/RA-MA 


MENÚS Y 
BARRAS DE HERRAMIENTAS 


Muchas aplicaciones simples tienen un formulario y varios componentes, pero no 
cabe duda de que su aspecto puede ser mejorado utilizando menús y barras de he- 
rramientas. Ambos componentes son familiares para los usuarios de interfaces 
gráficas; de ahí el interés por introducirlos en nuestras aplicaciones. Por eso dedi- 
caremos este capítulo a explicar cómo crear y utilizar menús en una aplicación, 
así como barras de herramientas. 


ARQUITECTURA 


A partir de NET Framework 2.0, ToolStrip es la clase base para controles como 
MenusStrip (barras de menús), StatusStrip (barras de estado) y ContextMenu- 
Strip (menús contextuales) entre otros. Todos estos controles actúan como conte- 
nedores, heredando de ToolStrip una conducta y un modelo de eventos común. 


Según se muestra en la figura siguiente, un objeto ToolStrip es un contenedor 
para objetos ToolStripltem. Esto es, cada objeto individual en un ToolStrip es 
un ToolStripltem que gestiona el diseño y el modelo de eventos para los tipos de 
objetos que encierra. Por ejemplo, los objetos visibles en una barra de herramien- 
tas, tales como botones, cajas de texto, etiquetas o listas desplegables, o bien los 
visibles en una barra de menús, se corresponden cada uno de ellos con un objeto 
ToolStripItem. 


En la figura siguiente vemos, en su parte derecha, los objetos que podemos 
colocar en un ToolStrip: 
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ToolStrip ToolStripltem 
MenusStrip ToolStripButton 
E  StatusStrip ToolStripControlHost 
ToolStripDropDown ToolStripComboBox 
=— ToolStripDropDownMenu =— ToolStripProgressBar 
ContextMenusStrip ToolStripTextBox 
ToolStripOverflow - ToolStripDropDownltem 
~  DataNavigator conteng ToolStripDropDownButton 
~ BindingNavigator ToolStripMenultem 
~ ToolStripSplitButton 
ToolStripLabel 
StatusStripPanel 
ToolStripStatusLabel 
ToolStripManager =— ToolStripSeparator 


e ToolStripButton proporciona un botón de pulsación típico que se puede 
configurar para que soporte tanto texto como imágenes. 


e ToolStripControlHost es un control que actúa como anfitrión de una 
implementación personalizada o de cualquier otro control de formulario 
Windows. 


e ToolStripComboBox es una lista desplegable con propiedades y métodos 
para configurar múltiples diseños. 


e ToolStripProgressBar es una barra de progreso. 
e ToolStripTextBox es una caja de texto normal. 


e ToolStripDropDownlItem proporciona la funcionalidad básica para los 
elementos que se despliegan cuando se hace clic sobre ellos. 


e ToolStripDropDownButton es un control que proporciona un botón que, 
cuando es pulsado, muestra un control ToolStripDropDown desde el que 
el usuario puede seleccionar un único elemento. 


e ToolStripMenultem es un objeto construido especificamente para ser 
utilizado con los controles MenuStrip y ContextMenuStrip. Se trata de 
un elemento de un menú. 


e ToolStripSplitButton es una combinación de un botón normal y un bo- 
tón de tipo ToolStripDropDownButton. 
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e ToolStripLabel se utiliza para visualizar texto normal, enlaces e imáge- 
nes. 
e  StatusStripPanel representa un panel en una barra de estado. 
e ToolStripStatusLabel representa una etiqueta en una barra de estado. 


e ToolStripSeparator es un elemento utilizado para separar visualmente 
grupos de objetos ToolStripltem. 


Todas estas clases pertenecen al espacio de nombres System.Windows.Form. 


MENÚS 


Un menú es una forma de proveer al usuario de un conjunto de órdenes, lógica- 
mente relacionadas, agrupadas bajo un mismo título. El conjunto de todos los títu- 
los correspondientes a los menús diseñados aparecerá en la barra de menús 
situada debajo del título del formulario. 


Título del menú Barra de menús 











Orden Abrir... Ctri+A 





Guardar Mismo nombre 





Separador 











Salir Otro nombre 














Cuando el usuario haga clic en un título de un menú, se desplegará una lista 
visualizando los elementos que contiene el menú. Los elementos de un menú pue- 
den ser órdenes, submenús y separadores. Cuando se hace clic en una orden o se 
selecciona y se pulsa Entrar, se ejecuta una acción o se despliega una caja de diá- 
logo. Por convenio, una orden seguida de tres puntos (...) indica que se desplegará 
una caja de diálogo. Cuando se selecciona un submenú, se despliega una nueva 
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lista de elementos. Un separador tiene como finalidad separar grupos de órdenes 
de un mismo menú; lógicamente, en función de su actividad. 


Para añadir una barra de menús, básicamente, disponemos de las clases Me- 
nuStrip, ToolStripMenultem y ToolStripSeparator que soportan la barra de 
menús, los menús de la barra y los elementos de los menús, y los separadores, 
respectivamente. Dicho de otra forma, MenuStrip es un contenedor para un menú 
de un formulario, al que se le pueden añadir objetos ToolStripMenultem (menús 
de la barra, submenús o los elementos de los menús) y ToolStripSeparator (se- 
paradores). Otros objetos que puede contener son ToolStripComboBox (listas 
desplegables) y ToolStripTextBox (cajas de texto). 


MenuStrip reemplaza a la clase MainMenu de versiones anteriores, aunque 
esta última se sigue conservando por compatibilidad. 


DISEÑO DE UNA BARRA DE MENÚS 


Para diseñar un menú, utilizaremos el editor de menús que se muestra en la figura 
siguiente. Comprobará que la edición es muy sencilla y vistosa. Basta con ir relle- 
nando las cajas de texto “Escriba aquí” con los nombres de los menús, submenús, 
órdenes o separadores que necesitemos. 





a9 Menús bakas 


Archivo | 
Abrir.. Ctri+A 


Guardar > || Mismo nombre 


Otro nombre 








Salir 











Para crear una barra de menús, los pasos a ejecutar son los siguientes: 


1. Arrastrar desde la caja de herramientas un control MenuStrip sobre el for- 
mulario. Esta acción abrirá de forma automática el editor de menús que per- 
mitirá añadir los menús, objetos de la clase ToolStripMenultem, a la barra 
de menús. 
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2. Introducir el título del menú. Escriba en la caja de texto “Escriba aquí” el títu- 
lo del menú que desea crear, el cual aparecerá en la barra de menús. Inserte un 
ampersand (8) antes de la letra que da acceso directo al menú para que apa- 
rezca subrayada. El usuario podrá seleccionar este menú, además de con el ra- 
tón, pulsando la tecla Alt más la tecla correspondiente a la letra que aparece 
subrayada. Asigne a su propiedad Name el nombre que se utilizará en el có- 
digo para referirse al menú. 


3. Introducir los elementos que componen el menú. Escriba en la caja de texto 
“Escriba aquí”, debajo del menú, el título del elemento del menú y asigne a su 
propiedad Name el nombre utilizado en el código para referirse a dicho ele- 
mento. Por ejemplo, observe el elemento Abrir..., en la figura anterior. Por 
convenio, un elemento de un menú seguido de tres puntos significa que cuan- 
do se haga clic sobre él, se desplegará una caja de diálogo. 


4. Crear un submenú. Un elemento puede ser una orden, o bien un submenú si a 
su vez despliega una lista de elementos. En ambos casos se trata de un objeto 
de la clase ToolStripMenultem. 


5. Añadir un separador. Utilizando separadores, objetos de la clase ToolStrip- 
Separator, puede agrupar las órdenes en función de su actividad. Para inser- 
tar un separador, escriba un único guión (-) en la caja de texto “Escriba 
aquí”. Tiene que especificar también un nombre cualquiera (Name). Por 
ejemplo, en la figura anterior puede ver un separador antes de la orden Salir. 


6. Cerrar el editor de menús. Una vez que haya finalizado el diseño, haga clic 
en cualquier lugar fuera de los menús para cerrar el editor. 


Otra forma de añadir un elemento ToolStripltem a un contenedor ToolStrip 
es seleccionándolo de la lista que se despliega a partir de la caja de texto “Escriba 
aquí” y estableciendo, a continuación, sus propiedades. 


A modo de ejemplo, siguiendo los pasos descritos anteriormente, vamos a 
crear el esqueleto para una nueva aplicación, denominada Menus (véase la figura 
anterior), que utilice un objeto Form como ventana principal a la que asignaremos 
el título “Menús”. El proceso de crear el esqueleto de una aplicación ya fue expli- 
cado en los capítulos anteriores, por lo que no nos detendremos más en estas cues- 
tiones. Esta aplicación se encuentra en la carpeta Cap05|Menus del CD. 


Crear un menú mediante programación 


Suponiendo que ya tiene realizado el esqueleto de la aplicación (formado por la 
clase Form1), vamos a analizar el código más relevante que el asistente para dise- 
ño de formularios añadió para crear la barra de menús: 
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1. Crear una barra de menús y añadirla al formulario. Básicamente, hay que 
crear un objeto de la clase MenuStrip y añadirlo al objeto Form1 (represen- 
tado en el código por this, palabra clave que puede omitirse): 


private MenuStrip BarraDeMenus; 
sos 
this.BarraDeMenus = new MenuStrip(); 














this.BarraDeMenus.Location = new Point(0, 0); 
this.BarraDeMenus.Name = "BarraDeMenus”; 
this.BarraDeMenus.Size = new Size(492, 24); 
this.BarraDeMenus.Tablndex = 3; 
this.BarraDeMenus.Text = "Barra de menús"; 

LA e 

this.MainMenuStrip = this.BarraDeMenus; 

















this.Controls.Add(BarraDeMenus); 


El código anterior crea un control barra de menús (objeto MenuStrip), de- 
nominado BarraDeMenus, y lo añade a la colección de controles (Controls) 
del formulario de la clase Form] invocando al método Add. Además, estable- 
ce la propiedad MainMenuStrip del formulario, aunque no es relevante. 


La propiedad Location especifica las coordenadas de la esquina superior iz- 
quierda del control relativas a la esquina superior izquierda de su contenedor. 


La propiedad Name puede utilizarse durante la ejecución para evaluar el obje- 
to por nombre en lugar de por tipo o a través del identificador. En otro caso, 
puede omitirse. 


La propiedad Size hace referencia al tamaño del control. 


La propiedad Tablndex hace referencia al orden Tab del control dentro de su 
contenedor. 


La propiedad Text hace referencia al texto que muestra el control. 


2. Añadir los menús a la barra de menús. Para crear un nuevo menú, hay que 
construir un objeto de la clase ToolStripMenultem, establecer sus propieda- 
des y añadirlo a la barra de menús. 


private ToolStripMenultem menuArchivo; 
Fa. 


menuArchivo = new ToolStripMenuItem(); 
menuArchivo.Name = "menuArchivo"; 
menuArchivo.Text = "&Archivo"; 


3. 


4. 
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BarraDeMenus.Items.AddRange( 
new ToolStripItem[] {menuArchivo}); 


El método AddRange añade uno o más menús (en nuestro caso menuArchi- 
vo) a la colección de objetos ToolStriplItem referenciada por la propiedad 
Items del control barra de menús. La colección es un objeto de la clase Tool- 
StriplItemCollection. 


Las otras propiedades ya han sido descritas. 
Añadir al menú los elementos que lo componen. Para crear un elemento de un 
menú, por ejemplo ArchivoAbrir, hay que construir un objeto de la clase 


ToolStripMenultem, establecer sus propiedades y añadirlo al menú. 


private ToolStripMenultem ArchivoAbrir; 


1! 
ArchivoAbrir = new ToolStripMenultem(); 
ArchivoAbrir.Name = "ArchivoAbrir":; 


ArchivoAbrir.Text "RAbrir..."; 





menuArchivo.DropDownlItems.AddRange( 
new ToolStripltem[] ([ArchivoAbrir)); 


El método AddRange ya fue definido anteriormente. En este caso lo utiliza- 
mos para añadir un elemento a la colección de elementos del contenedor 
ToolStripDropDown que está asociado con el objeto ToolStripDropDown- 
Item (menú archivo). Dicha colección está referenciada por la propiedad 
DropDownltems del menú y es de tipo ToolStripItemCollection. 


Añadir un submenú. Un elemento puede ser también un submenú. En reali- 
dad, se trata también de un objeto ToolStripMenultem añadido al menú. Por 
ejemplo, el código siguiente crea el submenú ArchivoGuardar y le añade dos 
elementos ToolStrip Menultem que suponemos creados: 


private ToolStripMenultem ArchivoGuardar; 
// 
ArchivoGuardar = new ToolStripMenuItem(); 


ArchivoGuardar.Name = "ArchivoGuardar"; 
ArchivoGuardar.Text = "&Guardar"; 
1! 





ArchivoGuardar.DropDownItems.AddRange( 
new ToolStripItem[] (ArchivoGuardarMismoNombre, 
ArchivoGuardarOtroNombre)); 
1! 
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menuArchivo.DropDownItems.AddRange( 


new Too1StripItem[] (ArchivoAbrir, ArchivoGuardar)):; 


5. Añadir un separador. Los separadores se utilizan para agrupar las órdenes en 
función de su actividad. Un separador es un objeto de la clase ToolStripSe- 
parator. El siguiente ejemplo añade un separador al menú Archivo antes de la 
orden Salir: 


private ToolStripSeparator Separadorl; 
Fi 
Separadorl = new ToolStripSeparator(); 


Separador1.Name = "Separador1"; 
// 


menuArchivo.DropDownItems.AddRange( 
new ToolStripItem[] {ArchivoAbrir, ArchivoGuardar, 


Separadorl, ArchivoSalir}); 


Los menús serán añadidos a la barra de menús en el orden en el que se ejecu- 
ten las correspondientes llamadas al método AddRange, si se hacen varias, o en 
el orden que se especifiquen, si solo realizamos una llamada a este método. Ídem 
para los elementos de un menú. 


Como ejercicio complete, si aún no lo ha hecho, el diseño de la barra de me- 
nús de la aplicación Menus cuya interfaz mostramos anteriormente. Después, 
guarde la aplicación, compílela y ejecútela. Compruebe cómo haciendo clic sobre 
cualquier menú este se despliega mostrando sus elementos. 


Controlador de un elemento de un menú 


En general, los elementos que componen cada menú no estarán operativos hasta 
que añadamos el código que responda al mensaje que se produce cuando se hace 
clic sobre alguno de ellos. 


Para escribir un método que responda al mensaje que se genera cada vez que 
el usuario hace clic en una orden de un menú, primero hay que asignar a dicha or- 
den un controlador de eventos Click. Por ejemplo, para asociar un controlador de 
eventos Click con la orden Salir del menú Archivo, diríjase al diseñador de for- 
mularios y haga doble clic sobre dicha orden. Después, complete el método aña- 
dido como se muestra a continuación. El resultado será el siguiente: 


// En InitializeComponent 
ArchivoSalir.Click += new EventHandler(ArchivoSalir_Click); 
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private void ArchivoSalir_Click(object sender, EventArgs e) 
( 
Close(); // cerrar el formulario principal 


} 


Cuando se cierra un formulario (Close), todos los recursos creados con el ob- 
jeto se cierran y se elimina el formulario. 


Para el resto de las órdenes procederemos de igual forma. De esta manera, ca- 
da orden tendrá asociado su propio controlador de eventos. Como ejercicio, puede 
añadir estos controladores para que simplemente muestren un mensaje indicando 
qué orden se ha ejecutado. Por ejemplo: 


private void ArchivoAbrir_Click(object sender, EventArgs e) 
{ 

System.Diagnostics.Debug.WriteLine("Archivo > Abrir"); 
) 


El método WriteLine de la clase Debug solo será tenido en cuenta si ejecuta 
la aplicación en modo depuración (F5). Otra forma de mostrar un mensaje al 
usuario, válida en cualquier modalidad, es utilizando el método Show de Mes- 
sageBox. La ejecución de este método mostrará una ventana con el mensaje espe- 
cificado: 


private void ArchivoAbrir_Click(object sender, EventArgs e) 
( 
MessageBox.Show("Archivo > Abrir"); 


} 


Aceleradores y nemónicos 


Sabemos que el nemónico de un menú o de alguno de sus elementos proporciona 
acceso directo desde el teclado. Un nemónico se distingue porque se corresponde 
con el carácter que aparece subrayado en el texto del control. Sirva de ejemplo el 
menú Archivo de la aplicación Menus o la orden Salir de este menú. El acceso 
desde el teclado se consigue pulsando las teclas A/t++nemónico. Por ejemplo, 
cuando el menú Archivo de la aplicación Menus está desplegado, pulsar las teclas 
Alt+S es equivalente a hacer clic en el elemento Salir de este menú. Si el menú no 
está desplegado, no se podrá acceder a sus elementos a través de sus nemónicos. 


Los aceleradores son muy similares a los nemónicos, excepto en que se puede 
especificar cualquier combinación de teclas de la forma: 


L(Ctri| Shift] A1t)]+[cualquier tecla) 


130 ENCICLOPEDIA DE MICROSOFT VISUAL C# 


(Shift = mayúsculas) y actúan independientemente de que el componente esté vi- 
sible o no. Por ejemplo, si asociamos el acelerador Ctr/+4 con la orden Abrir del 
menú Archivo de la aplicación Menus, siempre que se pulse esa combinación de 
teclas se ejecutará la orden Abrir, independientemente de que el menú Archivo es- 
té o no desplegado. Los aceleradores solo pueden estar asociados con elementos 
de un menú, no con menús. 


Como ejemplo, vamos a añadir a la aplicación Menus el código que asocie el 
acelerador CtrI+4 con la orden Abrir (identificada por el objeto ArchivoAbrir) del 
menú Archivo. Para ello, diríjase al diseñador de formularios, seleccione la orden 
Abrir, diríjase a la ventana de propiedades, seleccione la propiedad 
ShortcutKeys, despliegue el diálogo que le permitirá añadir el valor y seleccione 
Ctrl y A. Una vez realizada esta operación, el asistente añadirá el código siguien- 
te: 


ArchivoAbrir.ShortcutKeys = (Keys)(Keys.Control | Keys.A); 


La propiedad ShortcutKeys de la clase ToolStripMenultem permite esta- 
blecer un acelerador para un elemento de un menú. Tiene un parámetro que se co- 
rresponde con un valor del tipo enumerado Keys. Este valor especificará la tecla o 
combinación de teclas que darán lugar al acelerador. 


IMÁGENES EN CONTROLES 


Para asignar una imagen a un control (por ejemplo, a una orden de un menú o a un 
botón) hay que acceder a las propiedades Image e ImageTransparentColor del 
mismo. La primera permite asignar la imagen que será visualizada sobre el control 
y la segunda, si existe, el color, de entre todos los utilizados en el diseño de la 
imagen, que actuará de forma transparente cuando la imagen se ponga sobre el 
control, lo que permitirá ver el color de fondo de este. 


Recursos de una aplicación 


Los recursos gráficos son las imágenes que se definen para una aplicación. Estas 
pueden proceder de crear recursos gráficos nuevos, o bien de importar imágenes 
existentes, editarlas y, a continuación, agregarlas al proyecto. En nuestro caso, 
vamos a agregar al proyecto una carpeta Resources para guardar los ficheros que 
contienen las imágenes que vamos a utilizar. El diseñador de recursos genera los 
recursos en el espacio de nombres predeterminado del proyecto (en concreto, 
nombre_proyecto.Properties en Resources. Designer.cs). 


Para editar un recurso utilizando el editor predeterminado, diríjase al explora- 
dor de soluciones, haga clic con el botón secundario del ratón en la carpeta del 
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proyecto (por ejemplo, en Menus), seleccione Propiedades en el menú contextual 
que se visualiza, haga clic en la pestaña Recursos, seleccione el tipo de recurso en 
la primera lista desplegable (Imágenes en la figura) y elija en la segunda lista des- 
plegable, Agregar recurso, la opción que se ajuste a la operación que desea reali- 
zar, o haga doble clic sobre un recurso existente, si no está incrustado, para 
editarlo con el editor predeterminado, o bien haga clic sobre él con el botón se- 
cundario del ratón y elija el editor que desee. 


Forml.cs Forml.cs [Diseño] X 
Aplicación E Imágenes ~ Ý Agregar recurso ~ z 


Compilar 





Eventos de compilación 


Depurar a E 


Recursos 





Servicios imagenArchivoGuardar 
Configuración 

Rutas de acceso de referencia 

Firma 

Seguridad a E 


Publicar 


41 


imagenbtbarAbrir imagenbtbarGuardar aá 





Para eliminar un recurso, haga clic sobre él con el botón secundario del ratón 
y seleccione Quitar en el menú contextual que se visualiza. 


Los recursos pueden estar vinculados al proyecto o embebidos en el mismo. 
Por omisión están vinculados. Los recursos vinculados son almacenados como fi- 
cheros en el proyecto. En este caso, el fichero de recursos de la aplicación (.resx) 
almacenará el camino relativo que da acceso al fichero en el disco. 


Por ejemplo, si para nuestra aplicación Menus, disponemos de una imagen 
Menus\Resources\imagenArchivoAbrir.png de 16x16 píxeles y, siguiendo los pa- 
sos anteriormente descritos, la vinculamos con el proyecto, podremos observar 
que el código siguiente ha sido añadido al fichero Resources.Designer.cs: 


internal static System.Drawing.Bitmap imagenArchivoAbrir 
( 
get 
( 
object obj = ResourceManager.GetObject( 
a ", resourceCulture); 
return ((System.Drawing.Bitmap)(obj)); 
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Se trata de la propiedad imagenArchivoAbrir de la clase Resources del espa- 
cio de nombres Menus.Properties que devuelve el mapa de bits definido por el re- 
curso “imagenArchivoAbrir” correspondiente a la imagen aludida. Puesto que es 
static, para acceder a la misma emplee la sintaxis siguiente: 


Menus.Properties.Resources.imagenArchivoAbrir; 


Para tener acceso a los recursos de una referencia cultural determinada utili- 
zamos los métodos GetObject y GetString de ResourceManager. De forma 
predeterminada, estos métodos devuelven el recurso para la referencia cultural ac- 
tual. La clase ResourceManager proporciona un acceso a los recursos específicos 
de cada referencia cultural durante la ejecución. 


Para especificar la localización de esa imagen, será añadido en el fichero Re- 
sources.resx este otro código XML: 


<data name="imagenArchivoAbrir" 
type="System.Resources.ResxFileRef, System.Windows.Forms"> 
<value> 
¿System.Drawing.Bitmap, 
System.Drawing, Version=2.0.0.0, 
Culture=neutral, PublickKeyToken=b03f5f7f11d50a3a 
</value> 
</data> 


En cambio, cuando el recurso está embebido en el proyecto, se almacena di- 
rectamente en el fichero .resx. 


Para cambiar un recurso de vinculado a embebido, diríjase al explorador de 
soluciones, haga clic con el botón secundario del ratón en la carpeta del proyecto 
(por ejemplo, en Menus), seleccione Propiedades en el menú contextual que se 
visualiza, haga clic en la pestaña Recursos, seleccione el tipo de recurso, el recur- 
so, diríjase a la ventana de propiedades, seleccione la propiedad Persistencia y 
cámbiela a Embebido en .resx. Si realizamos este proceso sobre el recurso ima- 
genArchivoAbrir.png que añadimos anteriormente a la aplicación Menus y a con- 
tinuación, utilizando un editor XML, abrimos el fichero Resources.resx, 
podremos observar que ha cambiado en el sentido de que ahora, en lugar de espe- 
cificar la localización de la imagen, incluye la misma en formato binario: 


<data name="imagenArchivoAbrir" 
type="System.Drawing.Bitmap, System.Drawing" 
mimetype="application/x-microsoft.net.object.bytearray.baseb4"> 
<value> 
i VBORwOKGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAAXNSROIA... 
</value> 
</data> 
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Un fichero de recursos .resx es un fichero XML. Estos ofrecen la ventaja de 
que, al abrirlos con un editor de texto, es posible analizarlos, manipularlos y es- 
cribir en ellos. El código anterior, perteneciente al fichero Resources.resx, mues- 
tra que se puede observar realmente la forma binaria de un objeto embebido (en 
nuestro caso, la imagen definida por el recurso “imagenArchivoAbrir”. 


Los recursos embebidos son una buena solución cuando los ficheros de recur- 
sos (.resx) tienen que ser compartidos por múltiples proyectos, ya que de esta 
forma solo necesitaremos mantener una copia de los mismos. 


Los recursos no solo son imágenes, sino cadenas de caracteres (por ejemplo, 
los títulos de los elementos de un menú), iconos, ficheros de audio, etc. En una 
aplicación multilenguaje, lo ideal es crear recursos para cada idioma o, al menos, 
un subconjunto significativo del idioma en cuestión. 


Una vez añadido un recurso a un proyecto podemos utilizarlo allí donde lo 
necesitemos. Por ejemplo, vamos a hacer que la imagen añadida anteriormente se 
visualice en el elemento ArchivoAbrir del menú Archivo: 








a Menús bek 
Archivo | 
E Abrir.. Ctri+A » ] 
lA Guardar » 
Salir 














Para ello, seleccione este elemento y en la ventana de propiedades asigne a la 
propiedad Image el recurso ¿magenArchivoAbrir de Resources.resx. Finalmente, 
indique a través de la propiedad ImageTransparentColor qué color de la imagen 
será tratado como transparente (en nuestro caso, el color negro de fondo). Estas 
acciones añadirán a la clase Form] el siguiente código: 


ArchivoAbrir.Image = 


global: :Menus.Properties.Resources.imagenArchivoAbrir; 
ArchivoAbrir.ImageTransparentColor = System.Drawing.Color.Black; 


Como ejercicio, añada otra imagen, embebida, que se visualice con el elemen- 
to ArchivoGuardar del menú Archivo. 


LISTA DE TAREAS 


Muchos controles proporcionan una lista de tareas programadas. En este caso, el 
control visualizará en la esquina superior derecha un botón para mostrarla. Por 
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ejemplo, la figura siguiente muestra la lista de tareas programada para una barra 
de menús. 


En dicha lista podemos observar que hay una tarea programada para insertar 
los elementos estándar de una barra de menús. Esto es, los menús Archivo, Edi- 
ción, Herramientas y Ayuda. 





a Menús fe. fan | 
[e] LELER 
T: z 
Archivo N areas de MenuStrip 
| Incrustar en ToolStripContainer 


Insertar elementos estándar 





RenderMode | ManagerRenderMode |w| 





Dock Top X 











GripStyle Hidden 


a] 


Editar elementos... 








BARRA DE HERRAMIENTAS 


Una barra de herramientas es una ventana que normalmente contiene botones grá- 
ficos, aunque también puede contener otros controles, como, por ejemplo, cajas de 
texto o listas desplegables. Un clic en un botón de la barra de herramientas produ- 
ce los mismos eventos que un clic en la orden de un menú que realice su misma 
función o que el acelerador asociado con dicha orden. De hecho, las barras de he- 
rramientas y los menús están íntimamente relacionados. Normalmente, se añadirá 
un botón a una barra de herramientas para evitar al usuario la molestia de abrir un 
menú para ejecutar una determinada orden. 


2 Menús baba 


Archivo 
¡A d 








Diseño de una barra de herramientas 


Desde el punto de vista de la jerarquía de clases de la biblioteca .NET, una barra 
de herramientas es un objeto ToolStrip que actúa como contenedor para los obje- 
tos de las clases ToolStripButton, ToolStripLabel, ToolStripSplitButton, 
ToolStripDropDownButton, ToolStripSeparator, ToolStripComboBox, Tool- 
StripTextBox y ToolStripProgressBar. 
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Como ejemplo, vamos a añadir a la aplicación Menus anterior una barra de 
herramientas con dos botones: btbarAbrir y btbarGuardarMismoNombre, según 
muestra la figura anterior. 


Para añadir la barra de herramientas, arrastre desde la caja de herramientas de 
Visual Studio un control ToolStrip sobre el formulario y póngale como nombre 
BarraDeHerramientas. Después de estas acciones podrá comprobar que el asis- 
tente para diseño de formularios añadió a la clase Form/1 el siguiente código: 


private ToolStrip BarraDeHerramientas; 

1! 

BarraDeHerramientas = new ToolStrip(); 
BarraDeHerramientas.Location = new Point(0, 21); 


BarraDeHerramientas.Name = "BarraDeHerramientas”; 
BarraDeHerramientas.Tablndex = 1; 
// 


Controls.Add(BarraDeHerramientas):; 


Para añadir los botones a la barra de herramientas, ella misma proporciona 
uno que permite realizar esta acción. Haga clic sobre este botón (Añadir Tool- 
StripButton), o bien despliegue la lista de elementos que se pueden añadir y elija 
el tipo de control que desea añadir. 





all Menús | - l o |l 2s | 


Archivo 


o 














Button N 
Label 
SplitButton 











DropDownButton 
Separator 
ComboBox 
TextBox 


ProgressBar 


Amma >al 











Obsérvese que cada botón es un objeto de la clase ToolStripButton con una 
imagen predeterminada. Como ejemplo, vamos a añadir el botón btbarAbrir. 
Después, le pondremos una imagen, por ejemplo imagenbtbarAbrir, adecuada a la 
función que tiene que desempeñar. Para hacerlo, siga los pasos explicados en el 
apartado Recursos de una aplicación expuesto anteriormente en este mismo capí- 
tulo. Una vez realizado este proceso, el asistente para diseño habrá añadido a la 
clase Form/1 el siguiente código: 
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private ToolStripButton btbarAbrir; 
IF 
btbarAbrir = new ToolStripButton(); 
btbarAbrir.Name = "btbarAbrir"; 
btbarAbrir.ToolTipText = "Abrir" 
btbarAbrir.Image = 
global::Menus.Properties.Resources.imagenbtbarAbrir; 

btbarAbrir.ImageTransparentColor = System.Drawing.Color.Black; 























BarraDeHerramientas.Items.AddRange( 
new ToolStripItem[] {btbarAbrir}); 


Siguiendo un proceso análogo, añada a la barra de herramientas el botón 
btbarGuardarMismoNombre. 


Finalmente, asocie con cada botón el mismo controlador de eventos que tie- 
nen asociados sus Órdenes respectivas. Para ello, diríjase a la ventana de diseño, 
seleccione el botón, vaya a la ventana de propiedades y haga clic en su botón 
Eventos, seleccione el evento Click y elija de la lista de controladores existentes 
ArchivoAbrir_Click para el botón de abrir y ArchivoGuardarMismoNombre_Click 
para el de guardar. 


Compile la aplicación, ejecútela y pruebe los resultados. 


Nota: si observa la lista de tareas programadas de la barra de herramientas, 
verá que hay una tarea, Insertar elementos estándar, que permite insertar los ele- 
mentos estándar de una barra de herramientas. Esto es, los botones: Nuevo, Abrir, 
Guardar, Imprimir, Cortar, Copiar, Pegar y Ayuda. Ídem para la barra de menús. 


BARRA DE ESTADO 


Una barra de estado es un objeto que se visualiza normalmente en la parte inferior 
de un formulario. Contiene paneles (etiquetas) que muestran diferentes tipos de 
información, aunque también puede contener otros controles como, por ejemplo, 
botones o barras de progreso. La ventana de la figura siguiente muestra una barra 
de estado. 
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a Menús Lo ES 





Archivo 


Sy 

















Diseño de una barra de estado 


Desde el punto de vista de la jerarquía de clases de la biblioteca .NET, una barra 
de estado es un objeto StatusStrip que actúa como contenedor para los objetos de 
las clases ToolStripStatusLabel, ToolStripProgressBar, ToolStripDropDown- 
Button y ToolStripSplitButton. 


Como ejemplo, vamos a añadir a la aplicación Menus anterior una barra de 
estado con una etiqueta para mensajes (objeto ToolStripStatusLabel), según 
muestra la figura anterior, con la intención de mostrar en ella mensajes acerca de 
la función que realiza la orden que se seleccione del menú Archivo. 


Para añadir la barra de estado, arrastre desde la caja de herramientas de Visual 
Studio un control StatusStrip sobre el formulario y póngale como nombre Ba- 
rraDeEstado. Después de estas acciones podrá comprobar que el asistente para 
diseño de formularios añadió a la clase Form/1 el siguiente código: 


private StatusStrip BarraDeEstado; 

KETS 

BarraDeEstado = new StatusStrip(); 
BarraDeEstado.Location = new Point(0, 244); 


BarraDeEstado.Name = "BarraDeEstado"; 
BarraDeEstado.Tablndex = 2; 
// 


Control s.Add(BarraDeEstado); 


Para añadir un control a la barra de estado, ella misma proporciona un botón 
que permite esta acción. Haga clic sobre este botón (4ñadir ToolStripStatusLa- 
bel), o bien despliegue la lista de elementos que se pueden añadir y elija el tipo de 
control que desea añadir. 
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Como ejemplo, vamos a añadir una etiqueta denominada etbarestPpal. Se tra- 
ta de un control de la clase ToolStripStatusLabel. Una vez realizado este proce- 
so, el asistente para diseño habrá añadido a la clase Form] el siguiente código: 


private ToolStripStatuslabel etbarestPpal; 
NES 

etbarestPpal = new ToolStripStatusLabel(); 
PÍO Lao 

etbarestPpal.Name = "etbarestPpal”; 
etbarestPpal.Text = "Listo"; 


BarraDeEstado.Items.AddRange( 
new ToolStripltem[] ([etbarestPpal)); 


Obsérvese que inicialmente la etiqueta etbarestPpal muestra el mensaje “Lis- 
to”. Ahora, para que muestre información acerca de la función que realiza la or- 
den que se seleccione del menú Archivo, habrá que controlar cuándo el ratón entra 
en el elemento del menú (evento MouseEnter) y cuándo sale (evento MouseLea- 
ve). Por ejemplo, supongamos que cuando el ratón entra en la orden Salir desea- 
mos que la barra de estado muestre el mensaje “Cierra la aplicación”, y cuando 
sale, “Listo”. Siguiendo lo enunciado, añada los controladores indicados para los 
eventos indicados de Salir y complételos como se indica a continuación: 


private void ArchivoSalir_MouseEnter(object sender, EventArgs e) 
( 
etbarestPpal.Text = "Cierra la aplicación”; 


} 


private void ArchivoSalir_MouseLeave(object sender, EventArgs e) 
{ 

etbarestPpal.Text = "Listo"; 
) 


Compile la aplicación, ejecútela y pruebe los resultados. Como ejercicio, pue- 
de proceder de forma análoga con el resto de las órdenes ejecutables. 


DESARROLLO DE UN EDITOR DE TEXTOS 


Nuestra próxima aplicación va a consistir en el desarrollo de un editor de textos. 
Este editor, aunque de prestaciones muy limitadas, va a servir para poner en prác- 
tica los menús, las barras de herramientas y para incorporar nuevos conceptos 
como los aportados por las cajas de texto multilínea y el portapapeles (denomina- 
do Clipboard en Windows). 
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Un editor de textos parece, a simple vista, una aplicación muy complicada, 
pero ahora veremos que no es así. La plataforma .NET tiene clases de objetos que 
hacen sumamente sencillas aplicaciones como esta. 


Utilizando una definición sencilla, un editor de textos es una caja de texto con 
múltiples líneas, y Visual C# soporta este tipo de cajas. 





Archivo Edición Opciones 


¿ue 














Caja de texto multilínea 


De forma predeterminada, el control TextBox muestra una sola línea de texto y 
no muestra barras de desplazamiento. Entonces, si la longitud del texto es mayor 
que el espacio disponible, solo estará visible parte del texto. Este comportamiento 
predeterminado se puede cambiar estableciendo las propiedades MultiLine, 
WordWrap y ScrollBars con los valores apropiados. 


La propiedad MultiLine tiene como valor predeterminado false. En este caso, 
el control solo puede contener una línea de texto; en caso contrario, cuando vale 
true, el control puede contener varias líneas de texto. 


La propiedad WordWrap tiene como valor predeterminado true. En este ca- 
so, el texto del control aparecerá en uno o más párrafos; en caso contrario, valor 
false, las líneas no se partirán automáticamente, quedando oculta la parte de las 
mismas que quede fuera de los bordes de la caja de texto. En este último caso es 
recomendable utilizar una barra de desplazamiento horizontal. 


La propiedad ScrollBars permite mostrar en la caja de texto una barra de 
desplazamiento vertical u horizontal, o bien ambas. De forma predeterminada no 
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se muestra ninguna. Cuando la propiedad WordWrap valga true, la barra de 
desplazamiento horizontal no aparecerá. 


Otras propiedades de interés son AcceptsReturn, AcceptsTab y Dock. 


La propiedad AcceptsReturn determina si al presionar la tecla Entrar en una 
caja de texto multilínea se crea una nueva línea de texto (valor true) o activa el 
botón predeterminado del formulario (valor false). Si su valor es false, el usuario 
tendrá que pulsar Ctrl+Entrar para crear una nueva línea. Ahora bien, si el formu- 
lario no tiene ningún botón predeterminado, la tecla Entrar siempre creará una 
nueva línea, independientemente del valor de esta propiedad. 


La propiedad AcceptsTab determina si al presionar la tecla Tab en una caja 
de texto multilinea se escribe un carácter Tab en el control (valor true) en lugar 
de moverse el foco al siguiente control según el orden de tabulación (valor false). 


La propiedad Dock especifica el borde o bordes del contenedor principal al 
que se acoplará el control; en este caso, la caja de texto. 


Diseño del editor 


1. Inicie Visual CF y cree un nuevo proyecto para implementar el esqueleto para 
una nueva aplicación que utilice un formulario de tipo Form como ventana 
principal. Denomínela Editor. Ponga al formulario como título “Editor” y 
como nombre Form]. Esta aplicación se localiza en la carpeta Cap05 Editor 
del CD. 


// En Forml.cs 

public partial class Forml : Form 

i public Forml() 
InitializeComponent(); 

) 


// En Forml.Designer.cs 
public partial class Forml 


( 


11 
private void InitializeComponent() 
( 

11 

1! 

// Formi 


11 
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ClientSize = new Size(492, 266); 
Name = "Forml"; 
Text = "Editor"; 


) 


Añada a la aplicación una barra de menús, una barra de herramientas y una 
barra de estado. 


private MenuStrip BarraDeMenus; 
private ToolStrip BarraDeHerramientas; 
private StatusStrip BarraDeEstado; 

1/ 


BarraDeMenus = new MenuStrip(); 
BarraDeHerramientas = new ToolStrip(); 
BarraDeEstado = new StatusStrip(); 

Ie 





Controls.Add(BarraDeEstado); 
Controls.Add(BarraDeHerramientas); 
Controls.Add(BarraDeMenus); 








Añada una caja de texto de la clase TextBox que admita múltiples líneas y 
que muestre una barra de desplazamiento vertical. Denomínela ctEditor. Haga 
que la caja de texto se acople a todos los lados del formulario para que ocupe 
toda el área de trabajo. Observe los valores de las propiedades a continuación 
y establezca desde la ventana de propiedades los necesarios. 


private TextBox ctEditor; 


1! 

ctEditor = new TextBox(); 
PE Gas 

ctEditor.Name = "ctEditor":; 


ctEditor.Multiline = true; 
ctEditor.Dock = DockStyle.Fi11; 
ctEditor.AcceptsReturn = true; 
ctEditor.AcceptsTab = true; 
ctEditor.ScrollBars = ScrollBars.Vertical:; 
ctEditor.Location = new Point(0, 46); 
ctEditor.Size = new Size(492, 195); 
ctEditor.Tablndex = 2; 














1! 


Controls.Add(ctEditor); 


En el código anterior se puede observar que la propiedad Multiline de ctEdi- 
tor vale true, lo que define a este control como una caja de texto multilínea. 
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A la propiedad Dock se le ha asignado el valor Fill del tipo enumerado Do- 
ckStyle para que todos los bordes del control se acoplen a los bordes de su 
contenedor. A las propiedades AcceptsReturn y AcceptsTab se les ha asig- 
nado el valor true para que las teclas Entrar y Tab sean capturadas por este 
control. Y a la propiedad ScrollBars se le ha asignado el valor Vertical del ti- 
po enumerado ScrollBars para que el control muestre una barra de desplaza- 
miento vertical. La ruptura de líneas en el área de texto, propiedad 
WordWrap, está activada de forma predeterminada. 


Guarde la aplicación, compilela y ejecútela. Pruebe a escribir texto, actúe so- 
bre la barra de desplazamiento, modifique el texto, inserte texto, seleccione texto 
y borre texto. Como podrá comprobar, todas estas operaciones están implícitas sin 
escribir nada de código. 


Para hacer más operativo nuestro editor, vamos a añadirle las órdenes de Cor- 
tar, Copiar y Pegar. Estas órdenes nos permitirán seleccionar un texto y moverlo 
o duplicarlo dentro del mismo documento, o bien llevarlo a otro documento. 


El portapapeles 


El portapapeles permite transferir datos entre componentes, o bien entre aplica- 
ciones. Por ejemplo, muchas aplicaciones que manejan texto incluyen un menú de 
Edición con las órdenes Cortar, Copiar y Pegar. Cuando el usuario selecciona 
texto y ejecuta Cortar o Copiar, la aplicación transfiere los datos seleccionados 
en el documento al portapapeles y cuando ejecuta la orden Pegar, los transfiere 
del portapapeles al documento. Los datos seguirán en el portapapeles hasta que se 
ejecute la orden Cortar o Copiar nuevamente. 


La opción más sencilla para realizar esas operaciones es utilizar el portapape- 
les estándar del sistema que en .NET está representado por un objeto de la clase 
Clipboard del espacio de nombres System. Windows.Form. 


Objeto Clipboard 


Para colocar datos en el objeto Clipboard utilizaremos alguno de los métodos 
SetText, SetData, SetFileDropDownList, Setlmage o SetAudio, dependiendo 
del formato de los mismos. Por ejemplo: 


Clipboard.SetText("Esto es una cadena de texto"); 


Para leer los datos colocados en el objeto Clipboard utilizaremos alguno de 
los métodos GetText, GetData, GetFileDropDownList, Getlmage o GetAu- 
dioStream, dependiendo del formato de los mismos. Por ejemplo: 
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TextBox1.Text = Clipboard.Getlext(); 
Para limpiar el portapapeles utilizaremos el método Clear. Por ejemplo: 
Clipboard.Clear(); 


Los datos que podemos almacenar en el objeto Clipboard pueden estar en 
cualquier formato. Para determinar este formato podemos utilizar alguno de los 
métodos ContainsText, ContainsData, ContainsFileDropList, ContainsImage 
o ContainsAudio. Por ejemplo: 


if (Clipboard.ContainsImage() == true) 
Debug.Writeline("El portapapeles contiene una imagen"); 


Finalmente, el siguiente ejemplo muestra cómo guardar el contenido de un fi- 
chero de audio en el portapapeles: 


byte[] audio; 
audio = File.ReadAllBytes("miFichero.wav"); 
Clipboard.SetAudio(audio); 


Trabajar con texto seleccionado 


En cualquier editor de texto, el usuario puede seleccionar texto utilizando el ratón 
o el teclado. Con el ratón, apunte al comienzo del texto a seleccionar y arrastre 
con el botón izquierdo pulsado hasta haber seleccionado el texto deseado. Con el 
teclado, sitúe el punto de inserción donde desea iniciar la selección y, mantenien- 
do pulsada la tecla Shift (mayúsculas), desplace el punto de inserción utilizando 
las teclas de desplazamiento. Los controles de texto de .NET derivados de la clase 
TextBoxBase, como TextBox, ya incorporan esta característica. 


Además de la capacidad de selección, la clase TextBoxBase proporciona una 
serie de propiedades y métodos que permiten trabajar con el texto seleccionado a 
través del portapapeles, lo cual evita tener que recurrir a la clase Clipboard ex- 
puesta en el apartado anterior. Algunas de estas propiedades y métodos se expo- 
nen a continuación. 


Propiedades: 


SelectedText. Permite obtener el texto seleccionado, o bien reemplazar el texto 
seleccionado (puede ser nulo) por otro. 


SelectionStart, Permite obtener o establecer el punto de inicio del texto seleccio- 
nado en el control de texto. 
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SelectionLength. Permite obtener o establecer el número de caracteres seleccio- 
nados en la caja de texto. 


CanUndo. Permite saber si el usuario puede deshacer la operación anterior reali- 
zada en un control de texto. 
Métodos: 


void Copy(). Copia el texto actualmente seleccionado en el control de texto en el 
portapapeles. 


void Cut(). Mueve la selección actual del control de texto al portapapeles. 


void Paste(). Reemplaza la selección actual del control de texto con el contenido 
del portapapeles. 


void Clear(). Borra todo el texto del control de texto. 
void SelectAll(). Selecciona todo el texto del control de texto. 


void Select(int pos inicial, int pos final). Selecciona el texto que se encuentra 
entre las posiciones especificadas. 


void AppendText(string texto). Añade texto al texto actual del control de texto. 


void Undo(). Permite deshacer la última operación de edición. 


Diseño de la barra de menús 


Siguiendo con el diseño de la aplicación Editor, cree los menús Archivo, Edición 
y Opciones. Para este planteamiento inicial, suponga que el menú Archivo está 
formado solo por la orden Salir; el menú Edición, por las órdenes Cortar, Copiar 
y Pegar; y el menú Opciones, por los submenús Fuente y Tamaño. Algunas órde- 
nes como Cortar especifican a la derecha de su título el conjunto de teclas que 
hay que pulsar para ejecutar la orden directamente sin recurrir al menú; estas te- 
clas reciben el nombre de “aceleradores”. Las propiedades para cada uno de los 
elementos de los menús se resumen en la tabla siguiente. Para las propiedades que 
no figuran en la tabla, se asumen los valores predeterminados. En esta tabla se ha 
dispuesto cada menú con sus elementos, distinguibles por el nivel de sangrado. 


Archivo Name menuArchivo 
Text &Archivo 





Text &Salir 
Text &Edición 


CAPÍTULO 


Name 

Text 
hortcutKeys 
Name 

Text 
hortcutKeys 


Pegar 
hortcutKeys 


Baca E 
Text 








Name 
Text 
Name 
Text 
Name 
Text 
Name 
Text 
Name 
Text 
Name 
Text 
Name 
Text 
Name 
Text 
Name 
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EdicionCortar 
Cor&tar 

Ctrl+X 
EdicionCopiar 
&Copiar 

Ctrl+C 
EdicionPegar 
&Pegar 

Ctrl+V 
menuOpciones 
&Opciones 
OpcionesFuente 
&Fuente 
OpFuCouriernew 
Courier new 


Arial 
Predeterminada 
&Tamaño 

16 

24 


OpTamPredeterminado 
Predeterminado 





Como ejemplo, analizaremos el código que el diseñador de formularios ha 


añadido para implementar la orden Pegar 
































/1 


del menú Edición de la barra de menús: 


egar; 


em(); 


ources.imagenEdicionPegar; 

System.Drawing.Color.Black; 
( Control | Keys.V); 
22); 


private ToolStripMenuItem EdicionP 

1! 

BarraDeMenus = new MenuStrip(); 

enuEdicion = new ToolStripMenultem(); 

EdicionPegar = new ToolStripMenult 

loas 

EdicionPegar.Image = 
global::Editor.Properties.Res 

EdicionPegar.ImagelransparentColor = 

EdicionPegar.Name = "EdicionPegar"; 

EdicionPegar.ShortcutKeys = (Keys) 

EdicionPegar.Size = new System.Drawing.Size(155, 

EdicionPegar.Text = "&Pegar"; 
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menuEdicion.DropDownItems.AddRange(new ToolStripltem[] 


[EdicionCortar, EdicionCopiar, DD; 


BarraDeMenus.Items.AddRange(new ToolStripltem[] 


95) 


ADA 


[menuArchivo, , menu0pciones)); 
Analizando el código anterior, observamos que: 


Inicialmente se definen los objetos BarraDeMenus, menuEdicion y Edicion- 
Pegar, que darán lugar a la barra de menús, al menú Edición y a la orden Pe- 
gar de este, respectivamente. 

La propiedad Image establece la imagen para la orden Pegar. 

La propiedad ImageTransparentColor establece el color de la imagen que 
actuará como si fuera transparente. 

La propiedad Name establece el identificador de la orden Pegar. 

La propiedad ShortcutKeys asocia el acelerador Ctrl+V con la orden Pegar. 
La propiedad Text establece el título y el nemónico de la orden Pegar. 

Y, finalmente, se añade la orden Pegar al menú Edición y este a la barra de 
menús. 


Diseño de la barra de herramientas 


Continuando con el diseño de la aplicación Editor, cree una barra de herramientas 
con tres botones: Cortar, Copiar y Pegar. Las propiedades para cada uno de los 
botones se resumen en la tabla siguiente. Para las propiedades que no figuran en la 
tabla, se asumen los valores predeterminados. 


Botón de pulsación | Name btbarCortar 
(ToolStripButton) Image imagenbtbarCortar.png 


ImageTransparentColor | (según la imagen) 
toolTipText Cortar 


Botón de pulsación | Name btbarCopiar 


(ToolStripButton) Image imagenbtbarCopiar.png 
ImageTransparentColor | (según la imagen) 
toolTipText Copiar 

Botón de pulsación | Name btbarPegar 
(ToolStripButton) Image imagenbtbarPegar.png 
ImageTransparentColor | (según la imagen) 
toolTipText Pegar 





Como ejemplo, analizaremos el código que implementa el botón Pegar de la 


barra de herramientas: 
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private ToolStripButton btbarPegar; 
Id 
BarraDeHerramientas = new ToolStrip(); 
btbarPegar = new ToolStripButton(); 

// 


btbarPegar.Image = 
global::Editor.Properties.Resources.imagenbtbarPegar; 
rbarPegar.ImageTransparentColor = System.Drawing.Color.Black; 
btbarPegar.Name = "btbarPegar"; 

btbarPegar.ToolTipText = "Pegar"; 














BarraDeHerramientas.Items.AddRange(new ToolStripItem[] 


{btbarCortar, btbarCopiar, btbarPegar)); 


Analizando el código anterior, observamos que: 


1. Inicialmente se definen los objetos BarraDeHerramientas y btbarPegar, que 
darán lugar a la barra de herramientas y al botón Pegar de esta, respectiva- 
mente. 

2. La propiedad Image establece la imagen para el botón Pegar. 

3. La propiedad ImageTransparentColor establece el color de la imagen que 
actuará como si fuera transparente. 

4. La propiedad Name establece el identificador del botón Pegar. 

5. La propiedad ToolTipText asocia la descripción “Pegar” con el botón Pegar. 

6. El método AddRange añade el botón a la barra de herramientas. 


Finalizado el diseño, el resultado será similar al siguiente: 


ñ 
a9 Editor baba 


Archivo Edición | Opciones 
¿A Fuente » | Courier New 


Tamaño » Arial 



































Y | Predeterminada 
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Asociar un método con un elemento de un menú 


Una vez diseñada la interfaz, escribimos el código correspondiente para cada una 
de las órdenes de los menús. Anteriormente, en este mismo capítulo, ya expusi- 
mos que para escribir un método que respondiera al mensaje generado por una or- 
den de un menú después de haber hecho clic sobre ella, primero había que asignar 
a dicha orden un controlador de eventos Click. 


Archivo - Salir 


Para asociar un controlador de eventos Click con la orden Salir del menú Archivo, 
diríjase al diseñador de formularios y haga doble clic sobre dicha orden. Después, 
complete el método añadido como se muestra a continuación. El resultado será el 
siguiente: 


private void ArchivoSalir_Click(object sender, EventArgs e) 
( 

Close(); 
) 


El resto de las órdenes que expondremos a continuación se escriben de forma 
análoga. 


Edición - Cortar 


Cuando el usuario haga clic en la orden Cortar, se ejecutará el método asociado 
con ella. Por lo tanto, añada a la clase Form1 un controlador de eventos que ma- 
neje el evento Click de esta orden, moviendo el texto seleccionado en ctEditor al 
portapapeles: 


EdicionCortar.Click += new EventHandler(Ediciontortar_Click):; 


private void EdicionCortar_Click(object sender, EventArgs e) 
( 

ctEditor.Cut(); 
) 


El método Cut corta el texto que haya seleccionado en el objeto ctEditor y lo 
envía al portapapeles. 


El botón Cortar debe realizar la misma acción. Por lo tanto, debemos asociar- 
le el mismo controlador de eventos. Para ello, diríjase al diseñador de formularios, 
seleccione el botón, diríjase a la ventana de propiedades, muestre la lista de even- 
tos, seleccione el evento Click y elija de la lista el controlador EdicionCor- 
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tar Click. El resultado será que el método anterior manipulará tanto el evento 
Click de EdicionCortar como el evento Click de btbarCortar: 


btbarCortar.Click += new EventHandler(EdicionCortar_Click):; 
Edición - Copiar 


La orden Copiar se diferencia de la orden Cortar en que no borra el texto selec- 
cionado. Análogamente a como hicimos con la orden Cortar, añada en Form] un 
controlador de eventos que maneje el evento Click de esta orden, copiando el tex- 
to seleccionado en ctEditor en el portapapeles: 


private void EdicionCopiar_Click(object sender, EventArgs e) 
( 

ctEditor.Copy(); 
) 


El método Copy copia en el portapapeles el texto que haya seleccionado en el 
objeto ctEditor. 


El botón Copiar debe realizar la misma acción. Por lo tanto, debemos vincu- 
larlo con este mismo controlador de eventos. Para ello, proceda análogamente a 
como lo hizo con el botón Copiar. 


Edición - Pegar 


Cuando el usuario haga clic sobre la orden Pegar, se colocará el texto del porta- 
papeles sobre el texto seleccionado, o, en su defecto, a partir de la posición del 
punto de inserción. Para implementar esta orden, añada en Form] un controlador 
de eventos que maneje el evento Click de la misma, copiando el texto del porta- 
papeles en ctEditor: 


private void EdicionPegar_Click(object sender, EventArgs e) 
( 

ctEditor.Paste(); 
) 


El método Paste inserta el texto del portapapeles en el objeto ctEditor a partir 
del punto de inserción, o bien reemplaza el texto seleccionado. 


El botón Pegar debe realizar la misma acción. Por lo tanto, debemos asociarle 
el mismo controlador de eventos Click anterior. Para ello, proceda análogamente 
a como lo hizo con los botones Cortar y Copiar. 
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Opciones - Fuente 


A continuación, vamos a escribir el código para el menú Opciones. Este menú vi- 
sualiza dos submenús: Fuente, que presenta tres elementos que permiten cambiar 
el tipo de letra, y Tamaño, que presenta otros tres elementos que permiten cambiar 
el tamaño de la letra. 


El número de fuentes disponibles en Visual C# varía en función de la configu- 
ración de su sistema operativo. En nuestro editor solo vamos a incluir tres tipos: 
Courier new, Arial y el tipo de letra establecido de forma predeterminada. 


En una caja de texto de la clase TextBox solamente puede utilizarse una fuen- 
te, lo cual significa que cuando se modifique el tipo de letra para la caja de texto, 
todo el texto cambiará a ese tipo de letra. Por lo tanto, para cambiar la fuente en el 
editor de textos, simplemente tenemos que modificar la fuente actual de la caja de 
texto por medio de su propiedad Font. 


Según lo expuesto, añada en Form]1 un controlador de eventos que maneje el 
evento Click de la orden Courier new, estableciendo la nueva fuente: 


private void OpFuCourierNew_Click(object sender, EventArgs e) 
( 

Font f = ctEditor.Font; 

ctEditor.Font = new Font("Courier New", f.Size, f.Style); 
) 


Este método obtiene la fuente establecida actualmente, crea una nueva fuente 
manteniendo invariable el tamaño y el estilo, pero con un nombre determinado y, 
finalmente, asigna esta nueva fuente a la caja de texto. 


Para el objeto OpFuArial proceda de forma análoga; esto es, añada su contro- 
lador de eventos Click y escríbalo así: 


private void OpFuArial_Click(object sender, EventArgs e) 
( 

Font f = ctEditor.Font; 

ctEditor.Font = new Font("Arial", f.Size, f.Style); 
) 


A continuación, para poder restablecer la fuente con la que se inició la aplica- 
ción, vamos a almacenar en un objeto de la clase Font referenciado por la variable 
fuentePr las características del tipo de letra predeterminado de la caja de texto. 
Para ello, añada esta variable como miembro de la clase Forml: 


public partial class Forml : Form 
( 
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private Font fuentePr; 
1/ 
) 


Después, cuando se muestre la ventana que da lugar al editor (evento Load — 
cargar ventana) obtendremos la referencia a la fuente predeterminada con la que 
se ha creado el componente de texto y la almacenaremos en esa variable. Por lo 
tanto, añada el controlador para el evento Load del formulario y complételo como 
se indica a continuación: 


private void Forml_Load(object sender, EventArgs e) 
( 

fuentePr = ctEditor.Font; 
) 


Finalmente, añada en Form1 un controlador de eventos que maneje el evento 
Click de la orden Predeterminada, estableciendo la fuente predeterminada: 


private void OpruPredeterminada_Click(object sender, EventArgs e) 
( 

Font f = ctEditor.Font; 

ctEditor.Font = new Font(fuentePr.SystemFontName, f.Size, f.Style); 
) 


Este método obtiene la fuente establecida actualmente, crea una nueva fuente 
manteniendo invariable el tamaño y el estilo, pero con el nombre de la fuente pre- 
determinada y, finalmente, asigna esta nueva fuente a la caja de texto. 


Además del control TextBox, la biblioteca de .NET proporciona otro deno- 
minado RichTextBox que permite establecer el tipo de fuente a nivel de carácter. 


Opciones - Tamaño 


Análogamente a como sucede con el tipo de fuente, ocurre con el tamaño de la 
misma. Cuando se modifique el tamaño de la fuente para la caja de texto, todo el 
texto cambiará a ese tamaño. Por lo tanto, para variar el tamaño del texto que 
muestra el editor de textos, simplemente tenemos que modificar el tamaño de la 
fuente actual y establecer esta fuente de nuevo por medio de su propiedad Font. 


Según lo expuesto, añada en Form]1 un controlador de eventos que maneje el 
evento Click del objeto OpTam 16, estableciendo el tamaño 16: 


private void Oplaml6_Click(object sender, EventArgs e) 
( 
Font f = ctEditor.Font:; 
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ctEditor.Font = new Font(f.SystemFontName, 16.0F, f.Style); 
) 


Este método obtiene la fuente establecida por omisión, crea una nueva fuente 
manteniendo invariable el nombre de la fuente (la familia) y el estilo, pero con un 
tamaño determinado y, finalmente, asigna esta nueva fuente a la caja de texto. 


Para el objeto OpTam24 proceda de forma análoga; esto es, añada un contro- 
lador de eventos que maneje el evento Click, estableciendo el tamaño 24. 


A continuación, para poder restablecer el tamaño de la fuente con la que se 
inició la aplicación, utilizaremos el objeto Font referenciado por la variable fuen- 
tePr, Para ello, añada en Form1 un controlador de eventos que maneje el evento 
Click del objeto OpTamPredeterminado. ¿Cuál será la respuesta a este evento? 
Simplemente restablecer el tamaño predeterminado de la fuente, conservando la 
familia y el estilo: 


private void OplamPredeterminado_Click(object sender, EventArgs e) 
( 

Font f = ctEditor.Font; 

ctEditor.Font = new Font(f.SystemFontName, fuentePr.Size, f.Style); 
) 


Habilitar o inhabilitar los elementos de un menú 


Una orden de un menú puede ejecutarse solo si está habilitada. Esto quiere decir 
que una aplicación puede habilitar o inhabilitar los elementos de un menú, en fun- 
ción de que tengan o no actividad en el instante en el que el menú es desplegado. 
Cada vez que se selecciona un menú para desplegarlo se produce el evento Dro- 
pDownOpening, cuando está desplegado se produce el evento DropDown- 
Opened, cuando se hace clic en un elemento, el DropDownItemClicked y 
cuando se cierra, el DropDownClosed. Por lo tanto, podremos utilizar el evento 
DropDownOpening (se va a desplegar el menú) para mostrar habilitada cada or- 
den del menú que pueda desempeñar en este instante su función o, en caso contra- 
rio, mostrarla inhabilitada. 


Siguiendo con nuestra aplicación, el menú Edición tiene tres órdenes: Cortar, 
Copiar y Pegar. Un pequeño análisis nos puede conducir a la conclusión de que 
las órdenes Cortar y Copiar tiene sentido que estén activas si hay un bloque de 
texto seleccionado; en cambio, la orden Pegar estará siempre activa. 


Según lo expuesto, la condición para activar las órdenes Cortar y Copiar es 
que el usuario haya seleccionado un bloque de texto, lo que puede saberse inte- 
rrogando el valor de la propiedad SelectedText de la clase TextBox. 
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ctEditor.Selectedlext.Length != 0 


Esta propiedad hace referencia al objeto String que se corresponde con el tex- 
to seleccionado. Si no hay texto seleccionado, su longitud será cero, o lo que es lo 
mismo, la expresión anterior dará como resultado false. 


Para realizar el proceso descrito, añada en Form] un controlador de eventos 
que maneje el evento DropDownOpening del objeto menuEdicion. ¿Qué tiene 
que hacer este método? Simplemente asignar a la propiedad Enabled de las órde- 
nes Cortar y Copiar un valor true si hay texto seleccionado (habilitar órdenes), o 
false en caso contrario (inhabilitar órdenes). 


private void menuEdicion_DropDown0Opening(object sender, EventArgs e) 
( 
bool textoSeleccionado = (ctEditor.Selectedlext.Length != 0); 
EdicionCopiar.Enabled = textoSeleccionado; 
EdicionCortar.Enabled = textoSeleccionado; 


1 
J 


Marcar el elemento seleccionado de un menú 


Los elementos de un menú pueden ser marcados cuando son seleccionados, bien 
automáticamente poniendo su propiedad CheckOnClick a true, o bien bajo pro- 
gramación por medio de la propiedad Checked. Esto permite identificar de forma 
visual el elemento del menú actualmente seleccionado. 








Courier New Courier New 
Arial Arial 
Predeterminada [~] Predeterminada 








No marcado Marcado 


Como ejemplo, vamos a dejar señalada en el menú Fuente la fuente que está 
actualmente seleccionada. Quiere esto decir que cuando el usuario haga clic en un 
elemento de este menú, este debe quedar marcado y el que estaba marcado debe 
dejar de estarlo; esto descarta el uso de la propiedad CheckOnClick. Por otra par- 
te, cuando arranque la aplicación, el elemento Predeterminada debe aparecer se- 
ñalado. Esto puede hacerse durante el diseño, poniendo su propiedad Checked a 
valor true. 


Según lo expuesto, proceda paso a paso como se indica a continuación: 


1. Inicie la propiedad Checked del elemento Predeterminada con el valor true. 


OprFuPredeterminada.Checked = true; 
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2. Durante la ejecución, cuando el usuario seleccione otro tipo de letra, hay que 
quitar la señal de donde esté y ponerla en el tipo de letra seleccionado. Para 
realizar esta operación, modifique los controladores del evento Click de cada 
uno de los elementos del menú Fuente de la forma que se indica a continua- 
ción. Por ejemplo, el controlador de la orden Courier new quedaría así: 


private void OpFuCourierNew_Click(object sender, EventArgs e) 
( 
Font f = ctEditor.Font; 
ctEditor.Font = new Font("Courier New", f.Size, f.Style); 
OpFuCourierNew.Checked = true; 
OpFuArial.Checked = false; 
OpFuPredeterminada.Checked = false; 


Este método se ejecutará cuando se seleccione la orden Courier new, la cual 
quedará señalada porque pone su propiedad Checked a valor true. Así mismo, 
pone la propiedad Checked del resto de las órdenes a false para quitar la marca 
que pudiera tener cualquiera de ellas. 


Como ejercicio, proceda de forma análoga con el menú Tamaño. 


Deshacer 


Implementar la operación de Deshacer tiene dos partes: una, recordar las opera- 
ciones de edición realizadas para poderlas deshacer; y dos, añadir a la interfaz del 
usuario las órdenes que realicen ese trabajo. Como ejemplo, vamos a añadir a 
nuestra aplicación Editor estas operaciones. 


Recordar las ediciones reversibles 


Para que un componente de texto pueda soportar las operaciones de Deshacer y 
Rehacer debe recordar cada operación de edición que ha tenido lugar, el orden en 
el que se han sucedido y lo que supone el deshacerlas. Para realizar este trabajo, la 
clase TextBoxBase proporciona los métodos CanUndo y Undo. El primero per- 
mite saber si el usuario puede deshacer la última operación realizada en un control 
de texto y el segundo la deshace. Desgraciadamente, este control solo recuerda la 
última operación que tuvo lugar. 


Añadir a la interfaz la orden Deshacer 


El paso siguiente es añadir al menú Edición la orden Deshacer con su controlador 
de eventos correspondiente. Para ello, siga los pasos indicados a continuación: 
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1. Añada al menú Edición un componente EdicionDeshacer de la clase Tool- 
StripMenultem. Para ello, apunte con el ratón a la orden Cortar, haga clic 
con el botón secundario del ratón y ejecute Insertar Menultem. El código 
añadido por el asistente será análogo al siguiente: 


private ToolStripMenultem EdicionDeshacer; 
AE 
EdicionDeshacer = new ToolStripMenultem(); 
EL 
EdicionDeshacer.Image = 
global::Editor.Properties.Resources.imagenEdicionDeshacer; 
EdicionDeshacer.ImageTransparentColor = Color.Black; 
EdicionDeshacer.Name = "EdicionDeshacer"; 

EdicionDeshacer.Text = "4Deshacer"; 














2. Añada en Forml el controlador que maneje el evento Click de la orden Des- 
hacer. Para ello, haga doble clic sobre esta orden y escriba el controlador así: 


private void EdicionDeshacer_Click(object sender, EventArgs e) 
( 

if (ctEditor.CanUndo) ctEditor.Undo(); 
) 


El método CanUndo devuelve true si hay una operación de edición que se 
puede deshacer, y false en caso contrario. El método Undo deshace la última 
operación de edición que fue hecha. 


Listas desplegables en menús 


En la aplicación anterior, el menú Opciones presentaba otros dos menús: Fuentes 
y Tamaño, cada uno de los cuales presentaba, a su vez, tres posibilidades de elec- 
ción. El problema que planteamos a continuación consiste en sustituir el menú 
Opciones por dos listas desplegables: una que muestre las posibles fuentes que se 
pueden seleccionar, y la otra, los tamaños de las fuentes. La figura siguiente 
muestra el aspecto final que tendrá la barra de menús propuesta. 


Como se puede observar en la figura siguiente, un objeto ToolStripCombo- 
Box combina una caja de texto y una lista desplegable, permitiendo al usuario es- 
cribir una nueva entrada o seleccionar un elemento de la lista. El estilo de la lista 
viene determinado por su propiedad DropDownsStyle, que, por omisión, vale 
DropDown (caja de texto editable y una lista desplegable). 


Para resolver el problema planteado, primero elimine el menú Opciones de la 
aplicación anterior; para ello, diríjase a la ventana de diseño, selecciónelo y pulse 
la tecla Supr (suprimir o Del). Después, elimine todos los controladores relacio- 
nados con los elementos de ese menú. 
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Añada, desde la lista que se despliega a partir de la caja de texto “Escriba 
aquí” de la barra de menús, dos elementos ToolStripComboBox con las propie- 
dades que se observan en el código siguiente: 


private ToolStripComboBox menuFuente; 
private ToolStripComboBox menuTam; 
11 














menuFuente = new ToolStripComboBox():; 

menuTam = new ToolStripComboBox(); 

LEEF 

//menuFuente 

// 

menuFuente.Name = "menuFuente"; 

menuFuente.Size = new System.Drawing.Size(100, 21); 

// 

//menuTam 

// 

menuTam.Name = "menuTam”; 

menuTam.Size = new System.Drawing.Size(100, 21); 

// a 

BarraDeMenus.Items.AddRange(new ToolStripltem[] 
(menuArchivo, menuEdicion, menuFuente, menuTam)):; 


La propiedad Name identifica la lista y Size fija el tamaño del control lista sin 
desplegar. 


Para añadir los elementos a cualquiera de las dos listas durante el diseño, se- 
leccione la lista, diríjase a la ventana de propiedades, seleccione la propiedad 
Items, edítela y escriba los elementos que va a contener. También puede fijar a 
través de su propiedad Text el valor de la misma que será inicialmente mostrado. 
Estas operaciones hacen que el asistente añada código análogo al siguiente: 
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menuFuente.Text = "Predeterminada":; 
menuFuente.Items.AddRange(new Objectl[] 
("Courier new", "Arial", "Predeterminada")); 


La propiedad Items de la lista referencia la colección de elementos de la 
misma. Para añadir elementos a esta colección durante la ejecución, se puede uti- 
lizar el método AddRange, que permite añadir una matriz de elementos, o bien el 
método Add, que permite añadir un elemento cada vez. Cuando los elementos son 
añadidos a la lista uno a uno, se puede mejorar el rendimiento utilizando los mé- 
todos BeginUpdate y EndUpdate; el primero será invocado antes de iniciar la in- 
serción, para prevenir a la lista de que se repinte por cada elemento añadido, y el 
segundo será invocado una vez añadidos todos los elementos. 


Como siguiente paso, vamos a utilizar el controlador del evento Load del 
formulario para iniciar las listas (hay que elegir este método o el anterior, propie- 
dad Items, pero no ambos, ya que los elementos aparecerían duplicados): 


private void Forml_Load(object sender, EventArgs e) 
( 
menuFuente.Text = ctEditor.Font.SystemFontName; 
menuFuente.Items.AddRange(new object[] { 
"Courier New", "Arial", ctEditor.Font.SystemFontName )); 
menuTam.Text = ctEditor.Font.Size.ToString(); 
menuTam.Items.AddRange(new object[] { 
"16", "24", ctEditor.Font.Size.ToString() )); 








Nota: si durante la construcción de la lista, primero se añaden sus elementos 
(método AddRange) y después se asigna a la propiedad Text un elemento de la 
misma, 


menuFuente.Items.AddRange(new Object[] 
("Courier new", "Arial", "Predeterminada")); 
menuFuente.Text = "Predeterminada":; 


esta última acción producirá un evento SelectedIndexChanged; este evento no se 
producirá si estas operaciones las realiza en el orden inverso al expuesto. 


La propiedad SelectedIndex permite acceder al índice (a partir de cero) del 
elemento actualmente seleccionado en la lista y la propiedad Selected Item es una 
referencia a este elemento. 


Para buscar en la lista un elemento que contiene una determinada cadena de 
caracteres, disponemos de los métodos FindString y FindStringExact. 
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Cuando seleccionamos un elemento de la lista, se modifica su propiedad Se- 
lectedIndex para almacenar el índice del nuevo elemento seleccionado y esto ha- 
ce que se produzca el evento SelectedIndexChanged. 


Con lo expuesto, completamos el ejercicio. Cuando el usuario arranque la 
aplicación, escriba texto y decida cambiar la fuente por medio del control menu- 
Fuente, este control notificará de lo sucedido generando el evento SelectedIndex- 
Changed. La respuesta a este evento tiene que ser asignar a la caja de texto la 
fuente seleccionada, respetando el tamaño y el estilo de la misma. Según esto, 
añada el controlador mencionado y escríbalo como se indica a continuación: 


private void menuFuente_SelectedIndexChanged( 
object sender, EventArgs e) 
( 
ctEditor.Font = new Fontí(menuFuente.Selectedltem.ToString(), 
ctEditor.Font.Size, 
ctEditor.Font.Style); 


Este método crea una nueva fuente manteniendo invariable el tamaño y el es- 
tilo actuales, pero con el nombre de la fuente seleccionada de la lista y, finalmen- 
te, asigna esta nueva fuente a la caja de texto. 


Otra forma de realizar lo anterior, menos adecuada y con la necesidad de de- 
finir fuentePr como atributo privado de la clase Form] según vimos en la versión 
anterior, es la siguiente: 


Font f = ctEditor.Font; 























switch (menuFuente.Selectedindex) 
( 
case 0: 
ctEditor.Font = new Font("Courier new", f.Size, f.Style); 
case 1: 
ctEditor.Font = new Font("Arial", f.Size, f.Style); 
case 2: 
ctEditor.Font = new Font(fuentePr.SystemFontName, 


f.Size, f.Style):; 


Se puede observar que el código anterior fija el tipo de fuente en función del 
índice (SelectedIndex) del elemento seleccionado. 


Por otra parte, si el usuario opta por cambiar el tamaño de la fuente, entonces 
elegirá uno de los valores expuestos por el control menuTam, generándose el 
evento SelectedIndexChanged. Según esto, añada el controlador que maneje este 
evento y escríbalo como se indica a continuación: 
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private void menuTam_SelectedIndexChanged ( 
object sender, EventArgs e) 


( 
ctEditor.Font = new Font(ctEditor.Font.SystemFontName, 
float.Parse(menuTam.Selectedltem.ToString()), 
ctEditor.Font.Style); 


Este método crea una nueva fuente manteniendo invariable el nombre y el es- 
tilo actuales, pero con el tamaño seleccionado de la lista y, finalmente, asigna esta 
nueva fuente a la caja de texto. 


Esta aplicación se localiza en la carpeta Cap05|Editor-v2 del CD. 


MENÚS CONTEXTUALES 


Un menú contextual es visualizado sobre un formulario independientemente de la 
barra de menús, como se puede observar en la figura siguiente: 












1 








a9 Editor 
Archivo Edición DefaultFont ~ 7,2 X 
¿A 
Para visualizar un también denominado menú emergente, hay que crear un a 


objeto de la clase Context MenuStrip y después asociado a la propiedad ContextMenu Strip del 
formulario o del control correspondiente. 





Cortar — Ctrl+X 
Copiar Ctrl+C 
Pegar "Y Ctrl+V 























Para visualizar un menú contextual, también denominado “menú emergente”, 
hay que crear un objeto de la clase ContextMenuStrip y después asociarlo a la 
propiedad ContextMenuStrip del formulario o del control correspondiente. 


ContextMenusStrip reemplaza a la clase ContextMenu de versiones anterio- 
res, aunque esta última se sigue conservando por compatibilidad. 


Se utiliza para proporcionar a los usuarios un menú de fácil acceso para las 
órdenes de uso más frecuente asociadas al control seleccionado. Los elementos de 
un menú contextual suelen ser un subconjunto de los elementos de menús princi- 
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pales que aparecen en otros lugares de la aplicación. Los menús contextuales 
normalmente están disponibles con un clic del botón secundario del ratón. 


Por ejemplo, suponga que desea crear un menú emergente con las órdenes 


Cortar, Copiar y Pegar que se visualice al hacer clic con el botón secundario del 
ratón sobre el área de edición (nota: una caja de texto ya tiene asociado un menú 
contextual por omisión). Para que este menú forme parte de la caja ctEditor, siga 
los pasos expuestos a continuación: 


1. 


Diríjase a la caja de herramientas y haga doble clic sobre ContextMenusStrip. 
El control es añadido a la bandeja de controles (debajo del formulario) y tam- 
bién es añadido, con fines de edición, un menú al formulario (visualizando el 
texto “Escriba aquí”). Asigne a este control el nombre menuContexEdicion. 
El código añadido será el siguiente: 


private ContextMenuStrip menuContexEdicion; 


1! 

menuContexEdicion = new ContextMenuStrip():; 
PIE 

menuContexEdicion.Name = "menuContexEdicion”; 


menuContexEdicion.Size new Size(156, 92); 


Asocie el menú contextual con la caja de texto multilinea. Para ello, seleccio- 
ne la caja de texto, diríjase a la ventana de propiedades, seleccione su propie- 


dad ContextMenuStrip y asígnele el objeto menuContexEdicion. El código 
añadido será el siguiente: 


ctEditor.ContextMenuStrip = menuContexEdicion; 


Añada los elementos que lo componen siguiendo los pasos indicados ante- 
riormente cuando se explicó cómo crear un menú: 


private ToolStripMenultem ContextEdicionCortar; 
private ToolStripMenultem ContextEdicionCopiar; 
private ToolStripMenultem ContextEdicionPegar; 
// 
ContextEdicionCortar = new ToolStripMenuItem(); 
ContextEdicionCopiar = new ToolStripMenuItem(); 
ContextEdicionPegar = new ToolStripMenuItem(); 
BE 
menuContexEdicion.Items.AddRange(new ToolStripItem[] 
{ContextEdicionCortar, 
ContextEdicionCopiar, 
ContextEdicionPegar}); 
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4. Asocie los controladores de eventos Click con cada una de las órdenes. En 
nuestro caso, estos controladores son los mismos que hemos asociado con las 
órdenes Cortar, Copiar y Pegar del menú Edición. 


5. Asocie con el menú menuContexEdicion el controlador para su evento Ope- 
ning. Su función es análoga a la del controlador menuEdicion DropDown- 
Opening. 


Compile la aplicación, ejecútela y pruebe los resultados. 


Cuando los elementos de un menú, o bien los de un submenú, coinciden con 
los elementos de un menú contextual, no es necesario crear los elementos de ese 
menú o submenú, sino que se construye el menú contextual y se asigna a la pro- 
piedad DropDown del menú o del submenú. 


MENÚS DINÁMICOS 


Se denomina menú dinámico a aquel cuya colección de elementos puede variar 
durante la ejecución de la aplicación. 


Para saber qué código hay que escribir para añadir un elemento a un menú du- 
rante la ejecución, vamos a analizar el código que el diseñador de formularios es- 
cribe cuando hacemos esa operación durante el diseño. Para ello, vamos a partir 
de que tenemos construida una aplicación, MenusDinamicos, que muestra la si- 
guiente interfaz gráfica: 





6 


1 Menús dinámicos. 


Archivo | País 





Añadir 

















La figura anterior muestra una ventana con una barra de menús con dos me- 
nús: “Archivo” y “País”. Supongamos que el identificador de este último menú es 
menuPais. Añadir a este menú el elemento “Añadir” implica: 


1. Crear el elemento de tipo ToolStripMenultem: 


private ToolStripMenultem PaisAnadir; 


162 ENCICLOPEDIA DE MICROSOFT VISUAL CH 


PaisAnadir = new ToolStripMenultem(); 
2. Establecer sus propiedades, o bien aceptar los valores predeterminados. 


3. Añadir el elemento a la colección DropDownlItems de elementos del menú 
“País”: 


menuPais.DropDownItems.AddRange( 
new ToolStripltem[] ([PaisAnadir)); 


La propiedad DropDownlItems es un objeto de la clase ToolStripltem- 
Collection; se trata de un objeto colección al que podremos añadir elementos 
(AddRange para añadir una matriz de elementos o Add para añadir un solo ele- 
mento), o bien del que podremos eliminar elementos (Remove o RemoveAt), 
operaciones necesarias para trabajar con un menú dinámico. 


Según lo expuesto, el punto 3 anterior también podría realizarse así: 
menuPais.DropDownItems.Add(PaisAnadir); 


En este código se observa que el método Add añade a la colección de elemen- 
tos de menuPais un nuevo elemento referenciado por PaisAnadir. Ahora bien, 
cuando trabajemos con menús dinámicos, los elementos a añadir hay que crearlos 
dinámicamente (durante la ejecución), además de asociarlos con el controlador 
que responda a su evento Click. Para crearlos utilizaremos el constructor de la 
clase ToolStripMenultem siguiente: 


public ToolStripMenultem(string título) 


Quiere esto decir que durante el diseño solo hay que construir el menú (objeto 
contenedor; también podríamos crearlo durante la ejecución) y escribir el contro- 
lador que se vaya a utilizar para responder al evento Click de los elementos que 
añadamos durante la ejecución. El controlador será de la forma que se indica a 
continuación. Vamos a añadirlo a la clase Form]: 


private void ElementoMenuPais_Click(object sender, EventArgs e) 
( 

{F 
) 


A continuación, escribimos el controlador del evento Click del elemento 
“Añadir” para que permita añadir elementos al menú “País”. Los títulos de los 
elementos se corresponderán con nombres de países (en este ejemplo, estos nom- 
bres los simularemos de la forma “País +”). 
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Para probar cómo funciona la aplicación, vamos a hacer que ElementoMe- 


nuPais_Click muestre el título del elemento sobre el que hagamos clic. Finalmen- 
te, añadiremos el controlador de “Salir” para salir de la aplicación. El resultado, 
una vez realizado todo el proceso descrito, se muestra a continuación: 


public partial class Forml : Form 


( 


} 


public Forml1() 
( 

InitializeComponent(); 
) 


private void ElementoMenuPais_Click(object sender, EventArgs e) 
( 
ToolStripMenultem elemento = (ToolStripMenultem)sender; 
MessageBox.Show(elemento.Text); 
) 


private void PaisAnadir_Click(object sender, EventArgs e) 

( 
// Construir un título para el menú 
string titulo; 
titulo = "País " + (menuPais.DropDownItems.Count); 
// Crear un elemento con el título construido 
ToolStripMenultem elemento = new ToolStripMenultem(titulo); 
// Especificar cuál será su controlador de eventos Click 
elemento.Click += new EventHandler(ElementoMenuPais_Click); 
// Añadir el elemento al menú País 
menuPais.DropDownlItems.Add(elemento):; 

) 








private void ArchivoSalir_Click(object sender, EventArgs e) 
( 

Closely; 
) 


En este código se observa que tanto el menú “País” (identificado por me- 


nuPais) como el controlador ElementoMenuPais Click, para los elementos que se- 
rán añadidos dinámicamente, fueron añadidos durante el diseño. Recuerde que la 
sentencia elemento.Click += new EventHandler..., permite asociar el evento 
Click de elemento con un controlador de eventos. 


El resultado de ejecutar el código anterior será el siguiente: 
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Archivo | País 


Añadir 
País 1 
País 2 


País 3 


























A continuación, vamos a añadir otra orden “Eliminar” que permita quitar el 
último elemento añadido. Ahora, el menú “País” tendrá inicialmente dos elemen- 
tos, “Añadir” y “Eliminar”, y un separador. 


Añadimos los elementos “Eliminar” (PaisEliminar) y el separador (Separa- 
dorl) al menú “País”, y asignamos a su propiedad Visible el valor false. Después, 
modificamos el controlador PaisAnadir_Click como se indica a continuación: 


private void PaisAnadir_Click(object sender, EventArgs e) 
( 
// Inicialmente hay 3 elementos (dos ocultos) 
if (menuPais.DropDownItems.Count == 3) 
( 
// Hacer visibles los elementos Eliminar y el Separadorl 
PaisEliminar.Visible = true; 
Separadorl.Visible = true; 
) 
// Construir un título para el menú 
string titulo; 
titulo "País " + (menuPais.DropDownItems.Count - 2); 
// Crear un elemento con el título construido 
ToolStripMenultem elemento = new ToolStripMenultem(titulo); 
// Especificar cuál será su controlador de eventos Click 
elemento.Click += new EventHandler(ElementoMenuPais_Click); 
// Añadir el elemento al menú País 
menuPais.DropDownItems.Add(elemento); 





Il A 


~ 











Para finalizar, añadimos el controlador del elemento “Eliminar”. Cuando no 
haya elementos “país”, los elementos PaisEliminar y Separador] permanecerán 
ocultos; y cuando se añada el primer elemento “pais”, se harán visibles. Según es- 
to, edite el controlador PaisEliminar_Click como se indica a continuación: 


private void PaisEliminar_Click(object sender, EventArgs e) 
{ 

// Eliminar el último elemento 

int indUltimo = menuPais.DropDownItems.Count - 1; 
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menuPais.DropDownItems.RemoveAt(indUltimo); 

if (menuPais.DropDownItems.Count == 3) 

( 
// No quedan más países. Ocultar los elementos 
// Eliminar y el separador 
PaisEliminar.Visible = false; 
Separadorl.Visible = false; 


El método RemoveAt permite eliminar el elemento de la colección que está 
en la posición especificada (la primera posición es la cero). 


EJERCICIOS PROPUESTOS 


Se propone diseñar un reloj despertador digital que presente un aspecto como el 
que se muestra en la figura siguiente. Para ello necesitará conocer lo que es un 
temporizador, concepto que se expone en el apartado Temporizadores del capítulo 
Controles y cajas de diálogo. 





Archivo Despertador País Ayuda 


Hora: 
20:09:26 
Hora en 
Despertador: (hora local) 


00:00:00 20:09:26 











El reloj tiene una pantalla, c£Hora, para visualizar la hora, y una caja de texto 
denominada ctDespertador donde el usuario puede escribir la hora a la que quiere 
ser avisado. Para activar o desactivar el despertador, el usuario dispone de un me- 
nú denominado Despertador. 


La pantalla para visualizar la hora será una caja de texto de solo lectura con el 
fin de que el usuario no pueda modificarla. Para que la hora varíe segundo a se- 
gundo, debe actualizarse el contenido de la caja de texto que representa la hora, a 
intervalos iguales o inferiores a un segundo. 
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Hay otro menú, denominado País, que permitirá al usuario añadir países al 
propio menú, para después, haciendo clic sobre cualquiera de ellos, obtener en 
una tercera caja de texto, ctPais, la hora actual en ese país. Inicialmente, estos da- 
tos pueden ser recuperados de un fichero y almacenados en una matriz de objetos 
(país, diferencia horaria). Según esto, podemos posponer el diseño de las órdenes 
Añadir y Eliminar país para cuando hayamos estudiado cajas de diálogo en el si- 
guiente capítulo. Ídem con respecto a la orden Ayuda. 





GJ Reloj despertador. 








Archivo Despertador 


Ceg 
> ii: Eliminar ` 
Londres 

Atenas 

Roma 

Despertador: Nueva York 


00:00:00 TRP 


Hawai 











Finalmente, queremos que se visualice un menú flotante idéntico al mostrado 
por País, según se puede observar en la figura siguiente: 





SO Reloj despertador 








Archivo País 


© 


Despertador 


caa | Añadir | 
20:13:18 


Ayuda 














Londres 
Hora en A 
Despertador: (hora local) pa 
¡$__- Roma 






00:00:00 20:13:18 


Nueva York 


Tokyo 


Hawai 



















Para la realización del ejercicio se recomienda seguir los siguientes pasos: 
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Diseñar un formulario con barra de menús, barra de herramientas, barra de es- 
tado (si lo desea), tres etiquetas, dos cajas de texto, un control Masked- 
TextBox para el despertador y un temporizador. 


El menú Archivo tendrá un elemento Salir que cerrará el formulario. El menú 
Despertador tendrá un elemento que alternará entre Activar y Desactivar. El 
menú País tendrá, inicialmente, un elemento Añadir, otro Eliminar y un sepa- 
rador; estos dos últimos permanecerán ocultos cuando no haya países. El me- 
nú Ayuda tendrá un elemento Acerca de... 


La barra de herramientas tendrá un botón que alternará entre Activar y Desac- 
tivar el despertador. 


Presentar la hora en la caja de texto ctHora, lo que supone añadir un controla- 
dor asociado con Temporizador. Presentarla también en ctHoraPais. 


Limitar los caracteres en la caja de texto ctDespertador a dígitos y dos puntos 
(propiedad Mask de MaskedTextBox). Si se utilizara un TextBox, habría 
que manejar el evento KeyPress y permitir también la tecla de retroceso. 


Añadir a Form] un método, ObtenerHoraDespertador, que devuelva la hora 
del despertador en ticks (pasos; 1 paso = 100 nanosegundos). 


Modificar el controlador asociado con Temporizador para que haga sonar la 
alarma, si procede. Cuando suene la alarma y no sea desactivada, lo hará co- 
mo máximo durante cinco minutos. 


Añadir el controlador de la orden Activar del menú Despertador. Esta orden 
alternará entre Activar y Desactivar la alarma. Habilitar también, en el mismo 
sentido, el botón de la barra de herramientas. 


Añadir un menú contextual, inicialmente con una orden Añadir, otra Eliminar 
y un separador; estos dos últimos permanecerán ocultos cuando no haya paí- 
ses. 


El proceso de añadir países lo posponemos hasta el capítulo siguiente. Ahora 
podemos realizar una simulación análoga a la que fue expuesta anteriormente 
en este mismo capítulo, tanto para el menú País como para el contextual. 


CAPÍTULO 6 


O F.J.Ceballos/RA-MA 


CONTROLES 
Y CAJAS DE DIÁLOGO 


Un control es un componente de la interfaz de usuario que proporciona un com- 
portamiento interactivo determinado. Existen muchos controles en WinForms. 
Algunos, como las etiquetas, las cajas de texto, los botones de pulsación, los me- 
nús y los elementos de los menús, ya los hemos estudiado. Otros, como las casi- 
llas de verificación, los botones de opción, las listas, los controles de rango 
definido, el control de pestañas, los controles para la gestión de fechas, las tablas 
o los árboles, serán estudiados en este capítulo. 


Una caja de diálogo o cuadro de diálogo es una ventana destinada a mantener 
una conversación corta con el usuario para mostrar u obtener algún dato específi- 
co necesario para que la aplicación pueda continuar. Para mostrar u obtener los 
datos a los que nos referimos, la ventana incluirá los controles apropiados que 
permitan esas operaciones. De una forma sencilla, una caja de diálogo es un for- 
mulario, objeto Form, con su propiedad FormBorderStyle establecida en Fixed- 
Dialog. Las cajas de diálogo las podemos clasificar en: 


e Cajas de mensaje. Son cajas de diálogo creadas por medio del método Show 
de la clase MessageBox del espacio de nombres System. Windows.Forms. 


e Cajas de diálogo personalizadas. Son cajas de diálogo hechas a medida, para 
lo cual la biblioteca .NET proporciona la clase Form. 


e Cajas de diálogo estándar. Son cajas de diálogo muy comunes proporciona- 
das por clases del espacio de nombres System.Windows.Forms; por ejemplo, 
la caja de diálogo Abrir o Guardar proporcionada por la clase OpenFileDia- 
log o SaveFileDialog, respectivamente, el diálogo Color proporcionado por la 
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clase ColorDialog, o el diálogo Imprimir proporcionado por la clase 
PrintDialog. 


A diferencia de una ventana principal (ventana primaria), una caja de diálogo 
es una ventana secundaria que depende de otra. 


CAJAS DE DIÁLOGO MODALES Y NO MODALES 


Una caja de diálogo puede crearse modal o no modal. Cuando una aplicación ne- 
cesita datos adicionales de los usuarios para continuar, visualizará una caja de 
diálogo modal, esto es, una caja de diálogo que tiene que ser cerrada para poder 
continuar (normalmente pulsando el botón Aceptar o el botón Cancelar). Si no es 
así, estaremos en el caso de una caja de diálogo no modal, esto es, una caja de 
diálogo que no impide que el usuario active otras ventanas mientras está abierta. 


La clase MessageBox crea diálogos modales y la clase Form permite crear 
diálogos modales (utilizando ShowDialog) y no modales (utilizando Show). 


CAJAS DE MENSAJE 


La forma más fácil de mostrar un resultado o un mensaje es utilizando las cajas de 
diálogo que WinForms provee para estos propósitos y que se visualizan utilizando 
el método Show de la clase MessageBox. Este método, como veremos a conti- 
nuación, tiene varias sobrecargas. 


El método Show de la clase MessageBox visualiza un mensaje en una caja de 
diálogo semejante al de la figura mostrada un poco más adelante. Su sintaxis es la 
siguiente (los argumentos entre corchetes son opcionales): 


public static DialogResult Show( 
[IWin32Window propietario,] 
String mensaje 

[, String título 

, MessageBoxButton botones 

, MessageBoxImage ¡cono 

, MessageBoxResult botonPredeterminado 
, MessageBox0ptions opciones 

, String rutaFicheroAyuda, 

, HelpNavigator opcionesAyuda, 
, Object idTemaAyuda]]]]]]]] 








El segundo parámetro es obligatorio; el resto son opcionales. El significado 
de cada uno de ellos es el siguiente: 
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propietario — formulario propietario de la caja de mensaje. 
mensaje — texto a visualizar. 
título — título del diálogo. 


botones — uno de los valores de MessageBoxButtons que especifica los boto- 
nes que se mostrarán en el diálogo (esta enumeración es utilizada también por 
MessageBox): 


AbortRetrylgnore. El diálogo contiene los botones Anular, Reintentar y 
Omitir. 

OK. El diálogo contiene un botón Aceptar. 

OKCancel. El diálogo contiene un botón Aceptar y otro Cancelar. 
RetryCancel. El diálogo contiene un botón Reintentar y otro Cancelar. 
YesNo. El diálogo contiene un botón Sí y otro No. 

YesNoCancel. El diálogo contiene un botón Sí, otro No y otro Cancelar. 


icono — icono que se muestra en el diálogo. 


Information | Asterisk. El diálogo contiene un símbolo que consiste en una 
letra ¿ minúscula dentro de un círculo. 

Error | Hand | Stop. El diálogo contiene un símbolo que consiste en una X 
blanca dentro de un círculo con fondo rojo. 

Exclamation | Warning. El diálogo contiene un símbolo que consiste en un 
signo de exclamación dentro de un triángulo con fondo amarillo. 

None. El diálogo no contiene ningún símbolo. 

Question. El diálogo contiene un signo de interrogación dentro de un círculo. 


botonPredeterminado — uno de los valores de MessageBoxDefaultButton 
que especifica cuál es el botón predeterminado del cuadro de mensaje: 


Button1. Primer botón. 
Button2. Segundo botón. 
Button3. Tercer botón. 


opciones — uno de los valores de MessageBoxOptions que especifica las op- 
ciones de pantalla y asociación que se utilizarán para el diálogo: 


RightAlign. El texto del diálogo está alineado a la derecha. 

RtlReading. El texto del diálogo se muestra con orden de lectura de derecha a 
izquierda. 

ServiceNotification. El diálogo se muestra en el escritorio activo. 
DefaultDesktopOnly. Igual que ServiceNotification excepto en que el sis- 
tema muestra el diálogo solo en el escritorio predeterminado. 


rutaFicheroAyuda — el fichero de ayuda que se mostrará cuando el usuario 
haga clic en el botón de ayuda. 


172 ENCICLOPEDIA DE MICROSOFT VISUAL CH 


e  opcionesAyuda — opciones de la ventana de ayuda: Associatelndex, Find, 
Index, KeywordIndex, TableOfContents, Topic y Topicld. 


e  ¡dTemaAyuda — identificador del tema de ayuda que se mostrará cuando el 
usuario haga clic en el botón de ayuda. 


El método Show devuelve uno de los valores de DialogResult: 


Abort. Se pulsó el botón Anular. 

Cancel. Se pulsó el botón Cancelar. 

Ignore. Se pulsó el botón Omitir. 

No. Se pulsó el botón No. 

None. Significa que el cuadro de diálogo modal continúa ejecutándose. 
OK. Se pulsó el botón Aceptar. 

Retry. Se pulsó el botón Reintentar. 

Yes. Se pulsó el botón Sí. 


Por ejemplo, la sentencia 
MessageBox.Show("La palabra de paso no es correcta”, 


"Error"; 
MessageBoxButtons.0K, MessageBoxIcon.Error); 


visualiza la caja de diálogo siguiente: 





17 








El primer parámetro contiene el mensaje que se desea visualizar. El resto de 
los parámetros que le siguen son opcionales. 


En ocasiones tendremos que confirmar alguna acción. Por ejemplo, el seg- 
mento de código siguiente solicita una respuesta afirmativa para continuar. 


DialogResult respuesta; 

respuesta = MessageBox.Show("¿Desea continuar?", 
"Seleccione una opción", 
MessageBoxButtons.YesNo, 
MessageBoxIcon.Question):; 
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if (respuesta == DialogResult.Ves) 
MessageBox.Show("Se pulsó el botón Sí"); 
else 
MessageBox.Show("Se pulsó el botón No"); 


El diálogo que se visualiza es el siguiente: 





ñ 





Seleccione una opción . | | 


Q ¿Desea continuar? 





En función de la respuesta Sí o No dada, se ejecutará una u otra acción. 


CAJAS DE DIÁLOGO PERSONALIZADAS 


Además de los diálogos predefinidos, podemos crear nuestras propias ventanas de 
diálogo personalizadas mediante el diseñador de formularios. Basta con crear un 
objeto Form y agregar controles como Label, TextBox o Button, entre otros, pa- 
ra adaptar el diálogo a nuestras necesidades. 


Si observamos las aplicaciones realizadas hasta ahora, la interfaz gráfica que 
presentaban era un objeto de una clase derivada de Form y los controles, objetos 
miembro de dicha clase. Para crear un diálogo se sigue el mismo criterio; esto es, 
un diálogo será un objeto de una clase derivada de Form y los controles serán ob- 
jetos miembro de esta clase. Este diálogo será modal cuando se utilice el método 
ShowDialog para mostrarlo y no modal cuando se utilice el método Show. 


Como ejemplo, vamos a crear una aplicación denominada CajasDeDialogo 
que utilice un objeto Form como ventana principal, con la intención de visualizar, 
a partir de ella, otros diálogos. Para ello, cree el esqueleto de la aplicación y añada 
al formulario una barra de menús como muestra la figura siguiente. 


El menú Archivo contendrá solo una orden, Salir; el menú Diálogos inicial- 
mente lo dejamos vacío, y el menú Ayuda contendrá solo una orden, Acerca de. 
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Archivo Diálogos Ayuda 

















Supongamos ahora que deseamos que el usuario introduzca una palabra de 
paso (una clave) en el momento de ejecutar la aplicación. En el supuesto de que la 
palabra de paso introducida sea incorrecta, la aplicación lo notificará con un men- 
saje y le permitirá al usuario dos posibilidades más de subsanar el error. Las ope- 
raciones descritas habrá que realizarlas escribiendo el código necesario en el 
proceso de iniciación de la aplicación. Por lo tanto, añada a la clase del formulario 
Forml el controlador de su evento Load tal como se indica a continuación: 


private void Forml_Load(object sender, EventArgs e) 
( 
if (!Icontraseña()) Closeí); 
1 
Í 


El método contraseña, de la clase Forml, construirá la caja de diálogo, la 
mostrará para que el usuario pueda introducir la contraseña, y devolverá true si la 
contraseña fue correcta y false si, después de los tres intentos, fue incorrecta. 


Este diálogo de entrada podríamos construirlo diseñando una caja de diálogo 
personalizada con un control TextBox, entre otros, con su propiedad 
PasswordChar puesta al valor * (carácter asterisco). De esta forma, la caja de 
texto mostrará asteriscos (*) en lugar de los caracteres tecleados en la misma. 


Crear una caja de diálogo 


Para crear una caja de diálogo como la que acabamos de describir, durante la fase 
de diseño, siga los pasos indicados a continuación: 


1. Agregue un formulario al proyecto; para ello, diríjase al explorador de solu- 
ciones y haga clic con el botón secundario del ratón en el nombre del proyec- 
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to, seleccione Agregar y, a continuación, haga clic en Windows Forms. Asig- 
ne al formulario el nombre D/gPalabraDePaso. 


2. Asígnele como título “Palabra de paso”. 


3. Las cajas de diálogo no suelen incluir barra de menús, barras de desplaza- 
miento de ventana, menú de control, botones minimizar y maximizar, barra de 
estado ni borde de tamaño ajustable. Por lo tanto, en la ventana propiedades, 
cambie su propiedad FormBorderStyle a FixedDialog y las propiedades Mi- 
nimizeBox y MaximizeBox a false, o bien la propiedad ControlBox a false. 


4. Para que el diálogo se muestre inicialmente en el centro de la pantalla, asigne 
a su propiedad StartPosition el valor CenterScreen o CenterParent si desea 
que se muestre en el centro de la ventana propietaria. 


5. Normalmente, una caja de diálogo mostrará un botón Aceptar para que los 
usuarios puedan cerrar el diálogo y continuar con el proceso, otro botón Can- 
celar para que puedan cerrar el diálogo y detener el proceso iniciado, y, de 
forma predeterminada, un botón Cerrar en la barra de título del diálogo. 


6. Añada al formulario los controles necesarios. En nuestro caso añadiremos los 
controles con las propiedades especificados en la tabla siguiente: 


Valor 
Name etPalabraDePaso 
Text Introduzca la palabra de paso: 
Caja de texto Name ctPalabraDePaso 
A] PasswordChar * 
Modifiers Internal 


Botón de pulsación | Name btAceptar 

Text &Aceptar 

DialogResult OK 

Botón de pulsación | Name btCancelar 
Text &Cancelar 
DialogResult Cancel 








Asigne a la propiedad AcceptButton de la caja de diálogo el valor btAceptar 
para que este botón pueda ser activado, además de con un clic, también con la te- 
cla Entrar, y a CancelButton el valor btCancelar para que este otro botón pueda 
ser activado también con la tecla Cancelar. Estas acciones ponen la propiedad 
DialogResult de los botones a los valores OK y Cancel, respectivamente. 
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El proceso anterior ha dado lugar a que el asistente para diseño de formularios 
escriba la clase DlgPalabraDePaso que permitirá crear objetos (cajas de diálogo) 
con los atributos y métodos que hayamos establecido (propiedades, métodos, va- 
riables, controles, controladores de eventos, etc.). 


public partial class DlgPalabraDePaso : Form 

public DlgPalabraDePaso() 
InitializeComponent(); 

l ) 


Así, un objeto Dlg de la clase DlgPalabraDePaso, 


DlgPalabraDePaso Dlg = new DlgPalabraDePaso(); 


será una caja de diálogo como la siguiente: 














Mostrar una caja de diálogo 


El formulario de inicio (en nuestro caso Forml) se cargará automáticamente 
cuando se ejecute la aplicación. Para hacer que aparezca en la aplicación un se- 
gundo formulario o caja de diálogo, desde este formulario de inicio habrá que 
crear un objeto de su clase (new) y mostrarlo (ShowDialog o Show). Por ejem- 
plo: 


DlgPalabraDePaso Dlg = new DlgPalabraDePaso(); 


// Mostrar el diálogo y recuperar sus datos 
if (Dlg.ShowDialog() == DialogResult.OK) 

// Recuperar los datos del diálogo 
else 

// Continuar sin recuperar los datos 
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Del mismo modo, para hacer que desaparezca el formulario o caja de diálogo 
hay que escribir código para descargarlo u ocultarlo; lógicamente, esto ocurrirá 
automáticamente cuando el objeto creado salga fuera de ámbito, instante en el que 
se invocará al destructor de su clase (se invoca a Dispose). 


Analicemos la propiedad DialogResult del botón bt4ceptar. Si el valor de es- 
ta propiedad es distinto de None y el formulario se muestra mediante el método 
ShowDialog, al hacer clic en el botón se cierra el formulario (ocultándolo, no des- 
truyéndolo), sin necesidad de responder a ningún evento, y la propiedad Dialog- 
Result de este se establece con el valor de la propiedad DialogResult del botón. 
ShowDialog devuelve el valor de la propiedad DialogResult del diálogo. 


Según lo expuesto, para crear un cuadro de diálogo “Sí/No/Cancelar”, basta 
con agregar tres botones y asignar a sus propiedades DialogResult los valores 
Yes, No y Cancel, respectivamente. 


Introducción de datos y recuperación de los mismos 


Cuando el formulario de inicio necesite pedir datos al usuario, en muchos casos lo 
hará mostrando una caja de diálogo en la que el usuario los introducirá, y cuando 
este cierre el diálogo, el formulario de inicio recuperará esos datos desde los atri- 
butos del diálogo. 


Para recuperar los datos de una caja de diálogo es importante saber cómo se 
cerró: valor DialogResult devuelto por ShowDialog. Por ejemplo, si el usuario 
hace clic en el botón Aceptar, los datos se recuperarán, pero si lo hace en Cance- 
lar, los datos escritos por el usuario se desecharán en lugar de conservarse. 


if (Dlg.ShowDialog() == DialogResult.OK) 
sPalabraDePaso = Dlg.ctPalabraDePaso.Text; 
else 
return false; 


Obsérvese que Dlg.ShowDialog() devuelve el valor de la propiedad Dialog- 
Result del diálogo y que ha sido establecida con el valor de DialogResult del bo- 
tón al hacer clic sobre este. Esto quiere decir que, cuando no haya botones 
(incluso cuando los haya), puede establecer el valor de la propiedad DialogResult 
mediante código para posteriormente recuperarlo. Por ejemplo: 


public partial class DlgPalabraDePaso : Form 
( 
1! ; 
private void ctPalabraDePaso_KeyPress( 
object sender, KeyPressEventArgs e) 


( 
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if (e.KeyChar == Convert.ToChar(13)) 
DialogResult = DialogResult.OK; 





if (e.KeyChar == Convert.ToChar(27)) 
DialogResult = DialogResult.Cancel; 


Cuando el diálogo es modal y tiene un botón Cerrar (botón de la barra de títu- 


lo situado más a la derecha), al hacer clic en este botón, a diferencia de los formu- 
larios no modales (véase más adelante el apartado Ejercicios resueltos), no se 
llama al método Close, sino que el diálogo se oculta y la propiedad DialogResult 
se establece en Cancel. Esto permite volver a mostrarlo sin necesidad de tener 
que volver a crear un nuevo objeto. Debido a este comportamiento, para destruirlo 
cuando ya no lo necesite, deberá realizar una llamada a su método Dispose. 


Si al hacer clic en el botón Cerrar desea que la propiedad DialogResult tome 


un valor diferente a Cancel, utilice para ello el evento FormClosing del diálogo. 


Según lo expuesto y continuando con nuestro ejemplo, edite el método con- 


traseña como se indica a continuación: 


private bool contraseña() 


( 


int nCuenta = 0; 

string sPalabraDePaso; 

// Crear la caja de diálogo de entrada 

DlgPalabraDePaso Dlg = new DlgPalabraDePaso(); 

// Se admiten tres intentos para introducir la palabra de paso 


do 


( 


) 


// Mostrar el diálogo 

if (Dlg.ShowDialog() == DialogResult.O0OK) 
sPalabraDePaso = Dlg.ctPalabraDePaso.Text; 

else 
return false; 

// Verificar si la palabra de paso es correcta 

if (sPalabraDePaso.Length != 0 42 

sPalabraDePaso.CompareTo("Javier") != 0) 

( 
MessageBox.Show("La palabra de paso no es correcta", "Error", 

MessageBoxButtons.0OK, MessageBoxlcon.Error); 
nCuenta += 1; 

) 

else 
nCuenta = 4; 





while (nCuenta < 3); 
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if (sPalabraDePaso.Length == 0 || nCuenta == 3) 
return false; // salir de la aplicación 


return true; 


) 


Puede ver el código completo de esta aplicación en la carpeta 
Cap06 |CajasDeDialogo del CD que acompaña al libro. 


DIÁLOGO ACERCA DE 


El diálogo Acerca de tiene como finalidad mostrar los créditos de la aplicación. 
Siguiendo los pasos expuestos en los apartados anteriores, puede diseñar una caja 
de diálogo personalizada análoga a la de la figura siguiente. Para ello, haga clic 
con el botón secundario del ratón sobre el nombre del proyecto y ejecute Agregar 
> Nuevo elemento > Cuadro Acerca de con la intención de añadir una nueva caja 
de diálogo denominada DlgAcercaDe. Después, personalice el diseño como con- 
sidere oportuno. 





A 






Acerca de CajasDeDialogo 









CajasDeDialogo 
Versión 1.0.0.0 






Copyright © Fco. Javier Ceballos 







FJCS 





Controles y cajas de diálogo 














El diseño anterior ha sido realizado a partir del siguiente código: 


partial class DlgAcercaDe : Form 
( 
public DlgAcercaDe() 
( 
InitializeComponent(); 
this.Text = String.Format("Acerca de (0)", AssemblyTitle); 
this.labelProductName.Text = AssemblyProduct; 
this.labelVersion.Text = String.Format("Versión (0) 
AssemblyVersion):; 
this.labelCopyright.Text = AssemblyCopyright; 
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this.labelCompanyName.Text = AssemblyCompany; 
this.textBoxDescription.Text = AssemblyDescription; 


) 
1/ 


public string AssemblyCompany 
( 
get 
( 
object[] attributes = Assembly.GetExecutingAssembly(). 
GetCustomAttributes(typeof(AssemblyCompanyAttribute), false); 
if (attributes.length == 0) 
( 
return 
) 
return ((AssemblyCompanyAttribute)attributes[0]).Company; 


mu, 
> 


Observe que los valores para el diálogo son recuperados de los atributos glo- 
bales de la aplicación (véase el apartado Atributos globales de una aplicación del 
capítulo Aplicación Windows Forms). Por lo tanto, abra el fichero AssemblyIn- 
fo.cs del proyecto y revise los valores de los atributos del ensamblado. 


Finalmente, la función del botón Aceptar de este diálogo es cerrar el mismo. 


Para mostrar este diálogo añada a Forml1 el controlador para el evento Click 
de la orden Acerca de del menú Ayuda y complételo como se indica a continua- 
ción: 


private void AyudaAcercaDe_Click(object sender, EventArgs e) 
( 

DlgAcercaDe dlg = new DlgAcercaDe():; 

dlg.ShowDialog(); 
) 


FORMULARIO PROPIETARIO 


Un diálogo que se abre llamando al método ShowDialog o Show no tiene auto- 
máticamente una relación con el formulario que lo abrió: formulario propietario; 
esto es, el diálogo abierto no sabe qué formulario lo abrió. Esta relación puede es- 
tablecerse mediante la propiedad Owner del diálogo abierto y puede ser adminis- 
trado mediante la propiedad OwnedForms del formulario propietario. Por 
ejemplo: 
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private void MostrarDlg_Click(object sender, EventArgs e) 
( 
MiDlg dlg = new MiDlg(); 
dlg.Owner = this; 
if (dlg.ShowDialog() == DialogResult.0K) // o dlg.Show():; 
TUES rs 


O bien, pasando this como argumento en la llamada a ShowDialog o a Show: 


private void MostrarDlg_Click(object sender, EventArgs e) 

( 
MiDlg dlg = new MiDlg(); 
if (dlg.ShowDialog(this) == DialogResult.0K) // o dlg.Show(this); 
JU? 

) 


A diferencia de un diálogo abierto con ShowDialog, un diálogo que se abre 
llamando al método Show no impide que los usuarios interactúen con otras venta- 
nas de la aplicación. El método Show no devuelve nada, por lo que la propiedad 
DialogResult no tiene sentido en este tipo de diálogos. También, a diferencia de 
los diálogos no modales, el método Close para los diálogos modales simplemente 
oculta el diálogo, no destruye el objeto Form, por lo que es posible acceder a su 
funcionalidad pública desde cualquier parte en la que se disponga de una referen- 
cia al mismo; para destruirlo habría que llamar a Dispose. Cuando un diálogo ha 
sido eliminado, su propiedad IsDisposed devuelve true. 


La propiedad Owner de un diálogo tiene como función guardar una referen- 
cia al formulario propietario de ese diálogo (el valor predeterminado es null). De 
esta forma, utilizando el valor de Owner, el diálogo que es propiedad podrá acce- 
der a la funcionalidad pública de su formulario propietario. 


La propiedad OwnedForms obtiene una colección de formularios de los que 
un determinado formulario es propietario. 


OTROS CONTROLES WINDOWS FORMS 


Según lo estudiado hasta ahora, los formularios Windows Forms se llenan con 
elementos para formar la interfaz gráfica del usuario, pero solo algunos de estos 
elementos son controles, objetos derivados de la clase Control, entendiendo por 
control un componente con una representación visual en una interfaz gráfica. 


La clase System.Windows.Forms.Control añade la infraestructura básica 
para un control, requerida por las clases que muestran información al usuario. 
Controla los datos proporcionados por el usuario a través del teclado y dispositi- 
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vos como el ratón, controla la seguridad y el enrutamiento de mensajes, define los 
límites del control (posición y tamaño), pero no implementa su pintado, aunque es 
factible modificar el aspecto del control cambiando el valor de sus propiedades. 


La figura siguiente muestra los elementos que definen un control. El control 
expone una interfaz programática formada por propiedades, métodos y eventos. El 
control puede vincularse a determinados datos. Los elementos visuales del control 
se proporcionan por el propio control para presentar información al usuario y para 
aceptar información proporcionada por el usuario. 


Propiedades 


Todo esto ya lo hemos experimentado en mayor o menor medida en los capí- 
tulos anteriores, por lo que en este apartado vamos a exponer otros controles co- 
mo son las casillas de verificación, los botones de opción, las listas simples y 
desplegables, los controles de rango definido, el control de pestañas, los controles 
para la gestión de fechas, vistas como tablas y vistas jerarquizadas o árboles. 










Presentación 





Casillas de verificación 


Una casilla de verificación es un control que indica si una opción particular está 
activada o desactivada. En la caja de diálogo de la figura mostrada a continuación, 
se le da al usuario la opción de convertir el texto de la caja a mayúsculas. Cada 
casilla de verificación es independiente de las demás, ya que cada una de ellas tie- 
ne su propio identificador. El número de opciones representadas de esta forma 
puede ser cualquiera y, de ellas, el usuario puede seleccionar todas las que desee 
cada vez. La funcionalidad para manipular este tipo de controles es proporcionada 
por la clase CheckBox del espacio de nombres System. Windows.Forms. 
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Casilla de verificación 








Casilla de 
verificación TP Convertir a mayúsculas 

















S1 durante la ejecución se hace clic en una casilla de verificación, la opción 
queda seleccionada (M). Una opción ya seleccionada puede pasar a no estarlo ha- 
ciendo clic de nuevo sobre la casilla de verificación correspondiente (0). 


Un clic sobre un objeto CheckBox cambia su estado generando un evento 
CheckedChanged (evento predeterminado) seguido de un evento Click. Para sa- 
ber el tipo de cambio experimentado por la opción que originó el evento, hay que 
verificar el valor de la propiedad Checked de la misma. Este valor puede ser fal- 
se, la caja aparece vacía, o true, la caja aparece con una señal. 


La propiedad Appearance determina si la apariencia de este control es la tí- 
pica o como un botón de pulsación. 


La propiedad ThreeState determina si el control soporta dos o tres estados. 
De forma predeterminada, el control soporta dos estados identificados por la pro- 
piedad Checked. En el caso de que se programe para que soporte tres estados, es- 
tos se identificarían por la propiedad CheckState, que valdría Checked (casilla 
marcada), Unchecked (casilla vacía) o Indeterminate (casilla presentando una apa- 
riencia sombreada). En este supuesto, un clic sobre un objeto CheckBox genera 
un evento Click y cuando su estado cambia, un evento CheckedStateChanged. 


La propiedad FlatStyle determina el estilo y la apariencia del control: Flat, 
Popup, Standard o System, valores definidos por el tipo enumerado FlatStyle. El 
valor predeterminado es Standard. Cuando el valor es System, la apariencia del 
control estará determinada por el sistema operativo del usuario. 


Por ejemplo, el siguiente código verifica si el control CheckBox1 ha sido se- 
leccionado: 


if (CheckBox1.Checked) 
( 

// La casilla está marcada 
) 
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Para aplicar la teoría expuesta, vamos a diseñar una caja de diálogo como la 
de la figura anterior, de tal forma que cuando el usuario seleccione la opción 
“Convertir a mayúsculas”, todo el texto que haya escrito en la caja de texto apa- 
rezca en mayúsculas. El proceso para añadir una nueva caja de diálogo a una apli- 
cación ya fue expuesto anteriormente en este mismo capítulo. Según esto, cargue 
la aplicación CajasDeDialogo que hemos implementado anteriormente y añada 
una nueva caja de diálogo como la de la figura anterior. La caja de diálogo será un 
objeto de la clase DlgCasillaVerificacion derivada de Form. La tabla de controles 
y sus propiedades puede ser la siguiente: 


Caja de diálogo Name DlgCasillaVerificacion 
Text Casilla de verificación 
FormBorderStyle FixedDialog 
ControlBox false 
StartPosition CenterParent 


Caja de texto 


Casilla de verificación Name cvConverMayus 
Text Convertir a mayúsculas 


Botón de pulsación Name btAceptar 
Text SiAceptar 
DialogR esult OK 





Una vez finalizado el diseño, podremos observar que se ha añadido a la apli- 
cación una nueva clase DlgCasillaVerificacion a partir de la cual podremos crear 
ese tipo de cajas de diálogo. A continuación puede ver el código que necesita es- 
cribir para añadir a un diálogo una casilla de verificación: 


partial class DlglasillaVerificacion 
( 
IE gaa 
private CheckBox cvConverMayus; 
cvConverMayus = new CheckBox(); 


cvConverMay 
cvConverMay 
cvConverMay 
cvConverMay 
cvConverMay 
cvConverMay 


.Name = "cvConverMayus"; 

.Text = "&Convertir a mayúsculas"; 

.AutoSize = true; 

.Location = new System.Drawing.Point(29, 101); 
.Size = new System.Drawing.Size(131, 17); 
.TabIndex = 1; 














NNNNA 


Controls.Add(cvConverMayus); 
// 
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Para mostrar un diálogo modal de la clase DlgCasillaVerificacion, añadire- 
mos al menú Diálogos de la aplicación CajasDeDialogo un nuevo elemento Dia- 
logoCasillaV, y, después, escribiremos el controlador para su evento Click así: 


private void DialogolasillaV_Click(object sender, EventArgs e) 
( 
DlglasillaVerificacion Dlg = new DlgCasillaVerificacion(); 
Dlg.ShowDialog(); 
) 


Este método crea un nuevo objeto DlgCasillaVerificacion y lo muestra como 
una caja de diálogo modal. 


A continuación, escribimos el código que permita que la caja de diálogo se 
comporte de la forma descrita. Para ello, seleccione el control cvConverMayus y 
añada a la clase DlgCasillaVerificacion un controlador de eventos Checked- 
Changed que responda a la acción de cambiar el estado de la casilla de verifica- 
ción. Dicha respuesta será la ejecución del método siguiente: 


private void cvConverMayus_CheckedChanged(object sender, EventArgs e) 
( 
string texto = ctlexto.Text; 
if (cvConverMayus.Checked) 
ctTexto.Text = texto.ToUpper(); 
else 
ctTexto.Text = texto.ToLower(); 
ctTexto.Focus(); 
ctTexto.SelectionStart = ctlexto.Text.Llength; 




















Este método obtiene el texto de la caja de texto y lo escribe de nuevo en la 
misma en mayúsculas si se marcó la casilla de verificación, o en minúsculas si la 
casilla de verificación se dejó vacía. Finalmente, sitúa el foco, que estaba sobre la 
casilla de verificación, en la caja de texto y coloca el punto de inserción a conti- 
nuación del último carácter. 


Una solución más adecuada puede ser la siguiente: mientras la casilla no esté 
marcada, todo el texto que se escriba deberá visualizarse en minúsculas (indepen- 
dientemente de que estén o no activadas las mayúsculas); mientras la casilla esté 
marcada, todo el texto que se escriba deberá visualizarse en mayúsculas; y en un 
estado indeterminado, el texto que se escriba aparecerá tal cual. Para realizar esto, 
en primer lugar, asigne a la propiedad ThreeState de la casilla el valor true, y en 
segundo lugar, intercepte la tecla pulsada (evento KeyPress) y en función del es- 
tado de la casilla de verificación visualice el carácter como corresponda. La solu- 
ción a este planteamiento puede ser la siguiente: 
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private void ctlexto_KeyPress(object sender, KeyPressEventArgs e) 
( 
if (cvConverMayus.CheckState == CheckState.Unchecked) 
( 
if (char.IsUpper(e.KeyChar)) 
e.KeyChar = char.ToLower(e.KeyChar):; 
) 
else if (cvConverMayus.CheckState == CheckState.Checked) 
( 
if (char.IsLower(e.KeyChar)) 
e.KeyChar = char.ToUpper(e.KeyChar); 
) 
) 


private void cvConverMayus_Click(object sender, EventArgs e) 
( 

ctTexto.Focus(); 

ctTexto.SelectionStart = ctlTexto.Text.length; 





El método ctTexto_KeyPress visualiza el carácter tecleado en minúsculas 
siempre que la casilla no esté marcada (si el usuario tecleó una letra mayúscula, se 
convierte a minúscula), si está marcada, entonces se visualiza en mayúsculas (si el 
usuario tecleó una letra minúscula, se convierte a mayúscula), y en otro caso (es- 


tado indeterminado) se visualiza tal cual. 


El método cvConverMayus Click sitúa el foco, que estaba sobre la casilla de 
verificación, en la caja de texto y coloca el punto de inserción a continuación del 


último carácter. 


Botones de opción 


Un botón de opción es un control que indica si una determinada opción está acti- 
vada o desactivada. Cada botón de opción es independiente de los demás, ya que 
cada uno de ellos tiene su propio identificador. El número de opciones representa- 
das de esta forma puede ser cualquiera y, de ellas, el usuario solo puede seleccio- 
nar una cada vez. La funcionalidad para manipular este tipo de controles es 
proporcionada por la clase RadioButton del espacio de nombres System.Win- 


dows.Foms. 


Todos los controles RadioButton de un contenedor determinado, como 
Form, constituyen un grupo. Cuando el usuario selecciona un botón de opción en 
un grupo, los demás se desactivan automáticamente. Para crear varios grupos en 
un mismo formulario, coloque cada grupo en su propio contenedor, por ejemplo, 


en un control GroupBox o en un Panel. 
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Botones de opción 








© Decimal 


Octal 


5 Hexadecimal 

















Si durante la ejecución se hace clic sobre un botón de opción perteneciente a 
un grupo, la opción queda seleccionada (©) y, a diferencia de las casillas de veri- 
ficación, ese botón de opción ya seleccionado puede pasar a no estarlo haciendo 
clic en otro botón de opción del mismo grupo. 


Un clic sobre un objeto RadioButton cambia su estado generando un evento 
CheckedChanged (evento predeterminado) seguido de un evento Click. Para sa- 
ber el tipo de cambio experimentado por la opción que originó el evento, hay que 
verificar el valor de la propiedad Checked de la misma. Este valor puede ser fal- 
se, el botón aparece vacío, o true, el botón aparece con una señal. 


La propiedad Appearance determina si la apariencia de este control es la tí- 
pica o como un botón de pulsación. 


La propiedad FlatStyle determina el estilo y la apariencia del control: Flat, 
Popup, Standard o System, valores definidos por el tipo enumerado FlatStyle. El 
valor predeterminado es Standard. Cuando el valor es System, la apariencia del 
control estará determinada por el sistema operativo del usuario. 


Por ejemplo, el siguiente método verifica qué botón de opción está seleccio- 
nado de entre varios: 


private void Button1_Click(object sender, EventArgs e) 
( 
if (RadioButton1l.Checked) 
// RadioButtonl está seleccionado 
else if (RadioButton2.Checked) 
// RadioButton2 está seleccionado 


Tenga presente que cuando se hace clic sobre un botón de opción que perte- 
nece a un grupo, hay dos que cambian de estado: el que estaba seleccionado y el 
nuevo seleccionado. 
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Como ejemplo, cargue la aplicación denominada CajasDeDialogo, y añada 
una nueva caja de diálogo como la de la figura anterior, de tal forma que cuando 
seleccione uno de los botones de opción “Decimal”, “Octal” o “Hexadecimal”, el 
número tecleado en la caja de texto aparezca en la base indicada. Dicho diálogo 
será un objeto de la clase DlgBotonOpcion derivada de Form. La tabla de contro- 
les y sus propiedades puede ser la siguiente: 


Caja de diálogo 


Name 
Text 


FormBorderStyle 


ControlBox 
StartPosition 


DlgBotonOpcion 
Botones de opción 
FixedDialog 

false 

CenterParent 


Caja de texto 


Botón de opción 


gbGrupoBotonesl 
(nada) 


btopDecimal 


E <e 
Checked 


[AENA (MN 

&Octal 

Ta APPS 
&Hexadecimal 


btAceptar 
cet SiAceptar 


Dialogk esult OK 





Botón de pulsación 





Una vez finalizado el diseño, podremos observar que se ha añadido a la apli- 
cación una nueva clase DlgBotonOpcion a partir de la cual podremos crear ese ti- 
po de cajas de diálogo. A continuación puede ver el código necesario para añadir 
a un diálogo un botón de opción en un grupo de botones: 


partial class DlgBoton0Opcion 
( 

1! 
private GroupBox gbGrupoBotonesl; 
private RadioButton btopDecimal :; 


[00] 


btopDecimal = new RadioButton(); 
gbGrupoBotones1 = new GroupBox(); 


























btopDecimal.Name = "btopDecimal"; 
btopDecimal.Text = "&Decimal"; 
btopDecimal.AutoSize = true; 
btopDecimal.Checked = true; 
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btopDecimal.Location = new System.Drawing.Point(6, 19); 
topDecimal.Size = new System.Drawing.Size(59, 17); 


¡aj 

















btopDecimal.Tablndex = 0; 

gbGrupoBotones1.Name = "gbGrupoBtonesl1"; 
gbGrupoBotones1l.Location = new System.Drawing.Point(35, 47); 
gbGrupoBotones1.Size = new System.Drawing.Size(223, 100); 
gbGrupoBotones1l.Tablndex = 1; 

gbGrupoBotones1.TabStop = false; 
gbGrupoBotones1.Controls.Add(btopDecimal); 











Controls.Add(gbGrupoBotones1) 
1! 


El control GroupBox representa un control que crea un contenedor que tiene 
un borde y un encabezado (definido por su propiedad Text) para el contenido. 


Continuando con la aplicación, añada la orden Botón de opción al menú Diá- 
logos de la aplicación CajasDeDialogo, con la intención de que cuando el usuario 
haga clic en esa orden, se visualice una caja de diálogo de la clase DlgBotonOp- 
cion. Por lo tanto, añada a la clase Form1 el controlador del evento Click de este 
nuevo elemento y edítelo como se indica a continuación: 


private void DialogoBt0pcion_Click(object sender, EventArgs e) 
( 

DlgBoton0pcion Dlg = new DlgBotonOpcion(); 

Dlg.ShowDialog():; 
) 


Con esto hemos finalizado la fase de diseño. Compile y ejecute la aplicación, 
y observe los resultados. El siguiente paso es programar las operaciones para las 
que ha sido diseñado el diálogo: 


1. Cada vez que el usuario escriba o modifique el contenido de la caja de texto, 
esta se lo notifica a la caja de diálogo con el evento TextChanged (entre 
otros); para manipularlo, añada el controlador correspondiente. Para ello, dirí- 
jase al diálogo DlgBotonOpcion y haga doble clic en la caja de texto: 


private void ctDato_TextChanged(object sender, EventArgs e) 
( 


) 


2. Lo que va a hacer el método ctDato_TextChanged es almacenar el valor deci- 
mal, octal o hexadecimal de la caja de texto (dependiendo esto de la opción se- 
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leccionada), en una variable miembro denominada numeroActual de tipo 
Int32, de la clase DlgBotonOpcion (el tipo Int32 define valores enteros de 32 
bits y es independiente del sistema). Añada, por lo tanto, esta variable a la cla- 
se citada (su valor inicial predeterminado es 0). 


public partial class DlgBoton0pcion : Form 
( 

private int numeroActual; 

// 
) 


3. Después, edite el método privado c£Dato_TextChanged como se indica a con- 
tinuación: 


private void ctDato_TextChanged(object sender, EventArgs e) 
( 
if (ctDato.Text.Length == 0) return; 


string texto = ctDato.Text; 
int baseÑum = 0; 





if (btopDecimal.Checked) 
baseNum = 10; 

else if (btopOctal.Checked) 
baseÑum = 8; 

else if (btopHex.Checked) 
baseNum = 16; 














try 
( 
numeroActual = Convert.Tolnt32(texto, baseNum); 
) 
catch (FormatException ex) 
( 
if (texto == "-" || texto == "+") return; 
MessageBox.Show(ex.Message); 
) 
catch (Exception ex) 
( 
MessageBox.Show(ex.Message); 
) 
) 


El método TolInt32 de la clase Convert convierte una cadena de caracteres a 
un número entero de tipo Int32. La cadena a convertir se supone que está ex- 
presada en la base especificada por baseÑNum. 


CAPÍTULO 6: CONTROLES Y CAJAS DE DIÁLOGO 191 


4. Cuando el usuario seleccione una de las opciones Decimal, Octal o Hexadeci- 
mal, se producirá, entre otros, el evento CheckedChanged asociado con ese 
control; para manipularlo, añada el controlador correspondiente, que, en este 
caso, puede ser el mismo para los tres botones. Para ello, diríjase al diálogo 
DlgBotonOpcion, seleccione todos los botones de opción, elija ese evento en 
la ventana de propiedades y vincule con cada uno de los botones el método es- 
pecificado a continuación: 


private void btopDecOcHex_CheckedChanged(object sender, EventArgs e) 
( 

// 
) 


5. El método btopDecOcHex CheckedChanged tiene que mostrar en la caja de 
texto el valor numeroActual en decimal, octal o hexadecimal, respectivamente. 
También, el botón de opción sobre el que se ha hecho clic habrá quedado en- 
focado. Para situar el foco de nuevo en la caja de texto, invocaremos a conti- 
nuación a su método Focus. En base a lo expuesto, edite este método como se 
muestra a continuación: 


private void btopDecOcHex_CheckedChanged(object sender, EventArgs e) 
( 
if (btopDecimal.Checked) 
ctDato.Text = Convert.ToStrin 
else if (btopOctal.Checked) 
ctDato.Text = Convert.ToStrin 
else if (btopHex.Checked 
ctDato.Text = Convert.ToStringí(numeroActual, 16).ToUpper(); 
ctDato.Focus(); 
) 


eroActual, 10); 
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El método ToString de la clase Convert convierte un entero en la cadena de 
caracteres equivalente expresada en la base especificada y el método ToUpper 
de la clase String convierte a mayúsculas una cadena de caracteres. 


Listas simples 


Una lista es un control de la clase ListBox que pone a disposición del usuario un 
conjunto de elementos, que podrá elegir haciendo clic en ellos. La selección de los 
elementos puede ser simple o múltiple, dependiendo del valor de la propiedad Se- 
lectionMode. De forma predeterminada, los elementos de una /ista son visualiza- 
dos verticalmente en una sola columna, aunque si usted quiere, podrá establecer 
múltiples columnas poniendo la propiedad MultiColumn a valor true. 
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Cuando la lista muestra una sola columna y la cantidad de elementos rebasa el 
número de los que pueden ser visualizados simultáneamente en el espacio dispo- 
nible, aparecerá automáticamente una barra de desplazamiento vertical para que el 
usuario pueda desplazar los elementos de la lista hacia arriba o hacia abajo. En 
cambio, cuando la lista muestra múltiples columnas, los elementos son colocados 
en tantas columnas como sean necesarias, apareciendo automáticamente una barra 
de desplazamiento horizontal para que el usuario pueda desplazar las columnas 
hacia la izquierda o hacia la derecha, haciendo innecesaria de esta forma una barra 
de desplazamiento vertical. 
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Las propiedades Items, Selectedltems y SelectedIndices proporcionan acce- 
so a las tres colecciones que utiliza un control ListBox. La primera contiene todos 
los elementos de la lista, la segunda contiene los elementos seleccionados y la ter- 
cera, los índices de los elementos seleccionados. 


Para añadir elementos a la colección Items durante la ejecución, se puede uti- 
lizar el método AddRange, que permite añadir una matriz de elementos, o bien el 
método Add, que permite añadir un elemento cada vez. Cuando los elementos son 
añadidos a la lista uno a uno, se puede mejorar el rendimiento utilizando los mé- 
todos BeginUpdate y EndUpdate; el primero será invocado antes de iniciar la in- 
serción, para prevenir a la lista de que se repinte por cada elemento añadido, y el 
segundo será invocado una vez añadidos todos los elementos. 


Para buscar en la lista un elemento que contiene una determinada cadena de 
caracteres, disponemos de los métodos FindString y FindStringExact. 


La propiedad SelectedIndex permite acceder al índice (a partir de 0) del ele- 
mento actualmente seleccionado en la lista y la propiedad SelectedItem es una re- 
ferencia a este elemento. Precisamente, cuando seleccionamos un elemento de la 
lista, se modifica su propiedad SelectedIndex para almacenar el índice del nuevo 
elemento seleccionado y esto hace que se produzca el evento SelectedIndex- 
Changed (evento predeterminado). Cuando no hay ningún elemento selecciona- 
do, la propiedad SelectedIndex vale —1, y cuando hay varios elementos 
seleccionados almacena el índice del primero de la selección. La propiedad Sort, 
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cuando vale true, indica que los elementos de la lista se ordenarán alfabéticamen- 
te; su valor predeterminado es false. 


Diseñar la lista 


Generalmente, una lista es apropiada cuando se quiere limitar la entrada a una se- 
rie determinada de elementos. Como ejemplo, cargue la aplicación denominada 
CajasDeDialogo y añada una nueva caja de diálogo como la de la figura anterior, 
de tal forma que cuando seleccione uno o más elementos de la lista y pulse el bo- 
tón Aceptar, muestre su contenido en un diálogo de mensaje. La caja de diálogo 
será un objeto de la clase D/gListaSimple derivada de Form. La tabla de controles 
y sus propiedades puede ser la siguiente: 


Caja de diálogo Name DlgListaSimple 
Text Lista simple 
FormBorderStyle FixedDialog 
MinimizeBox false 


MaximizeBox false 


StartPosition CenterParent 


Botón de pulsación Name btAceptar 
Text SiAceptar 
Una vez finalizado el diseño, podremos observar que se ha añadido a la apli- 
cación una nueva clase DlgListaSimple a partir de la cual podremos crear ese tipo 


de cajas de diálogo. A continuación puede ver el código necesario para añadir una 
lista fija a un diálogo: 








partial class DlglListaSimple 
( 

1/ 

private ListBox IsLlistal; 


IsListal = new ListBox():; 





IsListal.Name = "lsListal"; 

IsLlistal.Location = new System.Drawing.Point(12, 12); 
IlsListal.Size = new System.Drawing.Size(180, 147); 
IsListal.Tablndex = 0; 





Controls.Add(lsListal); 
1/ 
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Para mostrar un diálogo de la clase DlgListaSimple, añadiremos al menú Diá- 
logos de la aplicación CajasDeDialogo una nueva orden Lista simple. Para ello, 
proceda de igual forma que cuando añadió las otras órdenes para mostrar los otros 
diálogos. El controlador asociado con esta orden será el siguiente: 


private void DialogolistaSimple_Click(object sender, EventArgs e) 
( 

DlgLlistaSimple Dlg = new DlglistaSimple(); 

Dlg.ShowDialog():; 
) 


Iniciar la lista 


La iniciación de una lista la podemos hacer durante el diseño, a través de su pro- 
piedad Items, o durante la ejecución en el instante en el que se carga el formula- 
rio, respondiendo al evento Load. 


Los elementos de la lista pueden ser cadenas de caracteres, imágenes o cual- 
quier otro elemento capaz de pintarse a sí mismo. Por ejemplo, vamos a añadir a 
la lista una serie de elementos de tipo String. Para ello, añadimos a la clase 
DlgListaSimple un método privado DlgListaSimple Load que se ejecute como 
respuesta al evento Load del diálogo: 


private void DlglistaSimple_Load(object sender, EventArgs e) 

( 
string[] elemento = new string[] { 
"uno", "dos", "tres", "cuatro", "cinco", "seis", "siete”, 
"ocho", "nueve", "diez", "once", "doce", "trece", "catorce" ys 
this.IlsListal.Items.AddRange(elemento); 


Este método inicia la lista /[sListal con los valores de la matriz elemento invo- 
cando al método AddRange de la colección Items. 


Acceder a los elementos seleccionados 


Para seleccionar un elemento de una lista, haga clic sobre él. Para seleccionar va- 
rios, solo si la propiedad SelectionMode lo permite, mantenga pulsada la tecla 
Ctrl o Mayús (Shift) y haga clic sobre los elementos que desea seleccionar. 


Para acceder al elemento seleccionado de una lista, utilizaremos la propiedad 
SelectedItem de la clase ListBox. Por ejemplo, vamos a añadir a la clase DlgLis- 
taSimple el controlador del evento Click del botón Aceptar para que cuando se 
ejecute, muestre el valor del elemento seleccionado: 
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private void btAceptar_Click(object sender, EventArgs e) 
( 
if (IsListal.Selectedindex < 0) return; 
object elementoSeleccionado; 
elementoSeleccionado = lsListal.SelectedItem; 
MessageBox.Show(elementoSeleccionado.ToString()); 


Si son varios los elementos seleccionados (propiedad SelectionMode = Mul- 
tiExtended, el valor por omisión es One: solo se puede seleccionar un elemento 
cada vez), pueden ser todos obtenidos por medio de la colección SelectedItems. 
Por ejemplo, para este caso, podemos modificar el método btAceptar Click para 
que muestre todos los elementos seleccionados así: 


private void btAceptar_Click(object sender, EventArgs e) 
( 
if (IsListal.Selectedindex < 0) return; 
strings = ""; 
for (int i = 0; i < IsListal.Selectedltems.Count; i++) 
s = s + ĮsListal.SelectedItems[i].ToString() + Environment.NewLine; 
MessageBox.Show(s); 


} 
Colección de elementos de una lista 


Anteriormente dijimos que la colección Items de un objeto ListBox se corres- 
ponde con los elementos mostrados por esa lista. Esta colección es de la clase Lis- 
tBox.ObjectCollection. Por lo tanto, las operaciones que realicemos sobre el 
contenido de la colección Items se reflejarán automáticamente en la lista. Estas 
operaciones se pueden resumir en añadir, insertar o quitar uno o más elementos de 
la lista. 


Echando una ojeada a la funcionalidad proporcionada por esta clase, obser- 
vamos que el método Add permite añadir un solo objeto a la colección y Add- 
Range permite añadir una matriz de objetos a la colección. Para insertar un objeto 
en una ubicación específica de la colección, utilizaremos el método Insert. Para 
quitar un elemento determinado, utilizaremos el método Remove, o bien Remo- 
veAt cuando la ubicación del elemento en la colección es conocida, o Clear si lo 
que queremos es quitar todos los elementos de la colección. 


Por ejemplo, vamos a modificar la caja de diálogo DlgeListaSimple para que 
permita realizar las operaciones anteriormente descritas. Para ello: 


1. Eliminamos el controlador del evento Load del diálogo DlgListaSimple. 
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2. Añadimos al diálogo otro botón, btAñadir, y una caja de texto, ctAñadir, que 
permita al usuario añadir un elemento a la lista. Para ello, procediendo de for- 
ma análoga a como hizo para poner el botón Aceptar, añada un nuevo botón 
btAñadir y asígnele un controlador de eventos Click como se muestra a conti- 
nuación: 


private void btAñadir_Click(object sender, EventArgs e) 
( 
// Añadir el elemento introducido en la 
// caja de texto ctAñadir 
if (ctAñadir.Text.Length != 0) 
IsListal.Items.Add(ctAñadir.Text); 
) 


3. Finalmente, añadimos otro botón, Borrar, que permita al usuario borrar un 
elemento seleccionado de la lista. Para ello, procediendo de forma análoga a 
como hizo para poner el botón Añadir, cree un nuevo botón btBorrar y asig- 
nele un controlador de eventos Click como se muestra a continuación: 


private void btBorrar_Click(object sender, EventArgs e) 
( 
if (IsListal.SelectedIndex < 0) return; 
lIsListal.Items.RemoveAt(lsListal.Selectedindex); 
) 


Compile la aplicación, ejecútela y analice los resultados. 





r 


Lista simple 


























Clase CheckedListBox 


Un objeto de la clase CheckedListBox es un objeto ListBox en el que se muestra 
una casilla de verificación a la izquierda de cada elemento. 


El usuario puede colocar una marca de verificación junto a uno o más elemen- 
tos y, después, puede explorar los elementos marcados a través de la propiedad 
CheckedItems (colección CheckedListBox.CheckedItemCollection de elemen- 
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tos activados) y de la propiedad CheckedIndices (colección CheckedList- 
Box.CheckedIndexCollection de índices activados). 


Listas desplegables 


Una lista desplegable es un objeto de la clase ComboBox. La diferencia entre una 
lista simple y una lista desplegable (también denominada cuadro combinado) es 
que la lista desplegable es una combinación de una lista simple y una caja de tex- 
to, y que permite la selección de un solo elemento cada vez. Hay tres estilos dife- 
rentes de listas desplegables: editable, no editable y estática, que pueden ser 
fijados mediante la propiedad DropDownStyle. Cuando una lista es editable 
(propiedad DropDownsStyle igual a DropDown, valor predeterminado), el usuario 
puede escribir información en la caja de texto de la misma, o bien seleccionar un 
elemento de la lista. Si la lista no es editable (propiedad igual a DropDownList), 
el usuario solo podrá seleccionar elementos de la lista. Y si la lista es estática 
(propiedad igual a Simple), esta se mantendrá siempre desplegada. 
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Por omisión, el número de elementos que muestra la lista emergente es ocho. 
Este valor puede ser modificado asignando a la propiedad MaxDropDownItems 
el valor deseado (para que esta propiedad tenga efecto en Windows Vista y ver- 
siones posteriores tiene que asignar a la propiedad IntegralHeight el valor false). 


La propiedad Items proporciona acceso a la colección que utiliza el Combo- 
Box para almacenar todos los elementos de la lista. Para añadir elementos a la co- 
lección Items durante la ejecución, se puede utilizar el método AddRange, que 
permite añadir una matriz de elementos, o bien el método Add, que permite aña- 
dir un elemento cada vez. Cuando los elementos son añadidos a la lista uno a uno, 
se puede mejorar el rendimiento utilizando los métodos BeginUpdate y EndUp- 
date; el primero será invocado antes de iniciar la inserción, para prevenir a la lista 
de que se repinte por cada elemento añadido, y el segundo será invocado una vez 
añadidos todos los elementos. 
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Para buscar en la lista un elemento que contiene una determinada cadena de 
caracteres, disponemos de los métodos FindString y FindStringExact. 


La propiedad SelectedIndex permite acceder al índice (a partir de 0) del ele- 
mento actualmente seleccionado en la lista, la propiedad SelectedItem es una re- 
ferencia a este elemento y la propiedad Text especifica la cadena que se muestra 
en la caja de texto. Cuando seleccionamos un elemento de la lista, se modifica su 
propiedad SelectedIndex para almacenar el índice del nuevo elemento seleccio- 
nado; esto hace que se produzca el evento SelectedIndexChanged (evento prede- 
terminado). Cuando no hay ningún elemento seleccionado, la propiedad Selected- 
Index vale —1. La propiedad Sort, cuando vale true, indica que los elementos de 
la lista se ordenarán alfabéticamente; su valor predeterminado es false. 


Diseñar la lista 


Como ejemplo, cargue la aplicación denominada CajasDeDialogo y añada una 
nueva caja de diálogo como la de la figura anterior, de tal forma que cuando se- 
leccione un elemento de la lista y pulse el botón Aceptar, muestre su contenido en 
un diálogo predefinido. La caja de diálogo será un objeto de la clase DlgLista- 
Desplegable derivada de Form. La tabla de controles y sus propiedades puede ser 
la siguiente: 


Caja de diálogo Name DlgListaDesplegable 
Text Lista desplegable 
FormBorderStyle FixedDialog 
MinimizeBox False 


MaximizeBox False 


StartPosition CenterParent 


Lista desplegable ldLista1 
Botón de pulsación Name btAceptar 
Text &Aceptar 


Una vez finalizado el diseño, podremos observar que se ha añadido a la apli- 
cación una nueva clase DlgListaDesplegable a partir de la cual podremos crear 
ese tipo de cajas de diálogo. A continuación puede ver el código necesario para 
añadir una lista desplegable a un diálogo: 








partial class DlgListaDesplegable 
( 

PP ets 

private ComboBox IdListal; 


ldListal = new ComboBox(); 
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ldListal.Name = "ldListal"; 

ldListal.Location = new System.Drawing.Point(13, 13); 
ldListal.Size = new System.Drawing.Size(169, 21); 
ldListal.Tablndex = 0; 

Controls.Add(ldListal); 


1/ 


Observe el código anterior y fíjese en cómo se implementa una lista desple- 
gable. Básicamente, basta con crear un objeto ComboBox y añadirlo a la colec- 
ción de controles del contenedor (en este caso del diálogo). 


Para mostrar este diálogo desde el menú Diálogos de la clase CajasDeDialo- 
go, añada al mismo una orden Lista desplegable. Para ello, proceda de igual for- 
ma que cuando añadió las otras órdenes para mostrar los otros diálogos. 


private void DialogolistaDesplegable_Click(object sender, EventArgs e) 
( 
DlglistaDesplegable Dlg = new DlglistaDesplegable(); 
Dlg.ShowDialog():; 
) 


Iniciar la lista 


Los elementos de la lista pueden ser cadenas de caracteres, imágenes o cualquier 
otro elemento capaz de pintarse a sí mismo. Al igual que explicamos al hablar de 
la clase ListBox, la lista de datos de un ComboBox se puede generar a partir de 
una matriz de tipo String, que pasaremos como argumento en el método Add- 
Range, que podemos invocar en el instante de cargar el diálogo, o bien añadir los 
elementos durante la ejecución utilizando ese método o el método Add. 


Acceder al elemento seleccionado 


Para acceder al elemento seleccionado de una lista desplegable (el que se muestra 
en la caja de texto), utilizaremos el método SelectedItem de la clase ComboBox. 
Por ejemplo, vamos a añadir a la clase DlgListaDesplegable un método privado 
para que al hacer clic en el botón Aceptar, se ejecute y muestre el valor del ele- 
mento seleccionado. Nos estamos refiriendo al controlador de eventos Click de 
este botón: 


private void btAceptar_Click(object sender, EventArgs e) 
( 

if (IdListal.Selectedindex < 0) return; 

object elementoSeleccionado; 

elementoSeleccionado = IdListal.SelectedItem; 
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MessageBox.Show(elementoSeleccionado.ToString()); 


Este método será invocado cuando el usuario haga clic en el botón btAceptar. 


Colección de elementos de una lista desplegable 


Anteriormente dijimos que la colección Items de un objeto ComboBox se corres- 
ponde con los elementos almacenados en esa lista. Esta colección es de la clase 
ComboBox.ObjectCollection. Por lo tanto, las operaciones que realicemos sobre 
el contenido de la colección Items se reflejarán automáticamente en la lista. Estas 
operaciones se pueden resumir en añadir (Add o AddRange), insertar (Insert) o 
quitar uno o más elementos de la lista (Remove, RemoveAt o Clear). 


Por ejemplo, vamos a modificar la caja de diálogo DlgListaDesplazable para 


que permita realizar las operaciones anteriormente descritas. Para ello: 


1. 


Eliminamos el controlador del evento Load del diálogo DlgListaDesplegable, 
si es que anteriormente lo utilizó para iniciar la lista. 


Añadimos al diálogo otro botón, btAñadir, y una caja de texto, ctAñadir, que 
permita al usuario añadir un elemento a la lista. Para ello, procediendo de for- 
ma análoga a como hizo para poner el botón Aceptar, añada un nuevo botón 
Añadir y asígnele un controlador de eventos Click como se muestra a conti- 
nuación: 


private void btAñadir_Click(object sender, EventArgs e) 
( 
// Añadir el elemento introducido en la 
// caja de texto ctAñadir 
if (ctAñadir.Text.Length != 0) 
ldlistal.Items.Add(ctAñadir.Text); 


Finalmente, añadimos otro botón, btBorrar, que permita al usuario borrar un 
elemento de la lista. Para ello, procediendo de forma análoga a como hizo para 
poner el botón btAñadir, cree un nuevo botón btBorrar y asígnele un controla- 
dor de eventos Click como se muestra a continuación: 


private void btBorrar_Click(object sender, EventArgs e) 
( 
if (ldListal.Selectedindex < 0) return; 
ldListal.Items.RemoveAt(ldListal.SelectedIndex); 
) 


CAPÍTULO 6: CONTROLES Y CAJAS DE DIÁLOGO 201 


La propiedad SelectedIndex de ComboBox devuelve el índice del elemento 
seleccionado en la lista (el primer índice es el 0; —1 si no hay ningún elemento se- 
leccionado) y el método RemoveAt de ComboBox.ObjectCollection elimina el 
elemento de la lista que tenga por índice el pasado como argumento. 


f Lista desplegable = 
jano] la] Aceptar 














uno a 




















Controles de rango definido 


Como su nombre indica, se trata de controles que definen un valor entero pertene- 
ciente a un rango previamente definido. A este grupo pertenecen los controles 
VScrollBar, HScrollBar, TrackBar y ProgressBar que, en este orden, podemos 
ver en la figura siguiente: 


fr 
Controles de rango definido = 























Todos estos controles de la biblioteca .NET definen básicamente las siguien- 
tes propiedades: 


e Minimum - indica el extremo inferior del rango de valores. 

e Maximum -indica el extremo superior del rango de valores. 

e Value — indica el valor actualmente seleccionado en el rango representado, 
especificado por el cursor del control. 


Si la propiedad TabStop vale true el usuario puede asignar el foco al control 
mediante la tecla Tab y utilizar el teclado para desplazar el cursor. 
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Cuando se modifica el valor de la propiedad Value, el control correspondien- 
te, excepto ProgressBar, generará un evento ValueChanged. 


ScrollBar 


Un objeto SerollBar es una barra de desplazamiento horizontal o vertical. Se trata 
de un control que tiene un cursor (un cuadrado) que se desplaza a lo largo de la 
misma para fijar un valor. La posición más a la izquierda o más arriba se corres- 
ponde con el valor mínimo, la posición más a la derecha o más abajo se corres- 
ponde con el valor máximo y cualquier otra posición es un valor entre estos dos. 
ScrollBar es la clase base de VScrollBar y HScrollBar, clases que dan lugar a 
las barras de desplazamiento vertical y horizontal, respectivamente. 


Para ajustar el intervalo de valores de estos controles, hay que establecer las 
propiedades Minimum y Maximum. Para ajustar los desplazamientos sobre la 
barra del cursor, hay que establecer las propiedades SmallChange, para los des- 
plazamientos cortos (cuando se hace clic en los extremos de la barra), y Lar- 
geChange, para los desplazamientos largos (cuando se hace clic entre el cursor y 
los extremos de la barra). Para ajustar el punto inicial del cursor, hay que asignar 
un valor inicial a la propiedad Value. 


Como ejercicio, añadiremos al menú Diálogos de la aplicación CajasDeDia- 
logo anterior un nuevo elemento “Controles de rango definido” de forma que 
cuando el usuario haga clic sobre él, se visualice una caja de diálogo como la que 
muestra la figura siguiente. La caja de diálogo será un objeto de la clase DlgCon- 
trolesRangoDefinido derivada de Form y mostrará un contador ascendente que 
será actualizado por un temporizador (véase el apartado Temporizadores al final 
de este capítulo). 





5 
Controles de rango definido =A 




















La actualización del contador se hará cada 10 * k milisegundos, donde k será 
un valor entre 1 y 150 proporcionado por la barra de desplazamiento que muestra 
la figura. Esto es, la velocidad de conteo será menor cuanto más a la derecha esté 
el cursor. 
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De acuerdo con el planteamiento del problema, pasamos a diseñar esa caja de 
diálogo. Asígnele el título “Controles de rango definido” y ponga sobre ella los 
controles con las propiedades que se especifican en la tabla siguiente. Ajuste los 
tamaños de los controles, así como el de la caja de diálogo. 


Caja de diálogo Name DlgControlesRangoDefinido 
Text Controles de rango definido 
FormBorderStyle FixedDialog 
MinimizeBox False 
MaximizeBox False 
StartPosition CenterParent 
Barra de desplazamiento | Name bdhIntervalo 
Minimum 
Maximum 
Value 
LargeChange 
SmallChange 
Etiqueta Name etContador 
Autosize false 
BorderStyle Fixed3D 
0 
MiddleCenter 








La propiedad LargeChange de la barra de desplazamiento define el valor que 
se desplazará el cursor cuando se haga clic en la barra y SmallChange define el 
desplazamiento que se realizará cuando se haga clic en los botones de los extre- 
mos de la barra. 


Una vez finalizado el diseño, podremos observar que se ha añadido a la apli- 
cación una nueva clase DlgControlesRangoDefinido a partir de la cual podremos 
crear ese tipo de cajas de diálogo. A continuación puede ver el código necesario 
para añadir una barra de desplazamiento horizontal a un diálogo: 


partial class DlgControlesRangoDefinido 
( 
E ais 
private System.Windows.Forms.HScrollBar bdhIntervalo; 


bahintervalo = new HScrollBar(); 


bahintervalo.Name = "bdhIntervalo"; 
bahintervalo.Maximum = 150; 
bdhintervalo.Minimum = 1; 
bdhintervalo.Value = 76; 
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bdhIntervalo.Location = new System.Drawing.Point(27, 40); 
bdhIntervalo.Size = new System.Drawing.Size(239, 20); 
bdhIntervalo.Tablndex = 1; 


Controls.Add(bdhIntervalo):; 
1/ 


Para mostrar este diálogo desde el menú Diálogos de la clase CajasDeDialo- 
go, añada al mismo una orden denominada DialogoRangos. Para ello, proceda de 
igual forma que cuando añadió las otras órdenes para mostrar los otros diálogos. 


private void DialogoRangos_Click(object sender, EventArgs e) 

( 
DlgControlesRangoDefinido Dlg = new DlgControlesRangoDefinido():; 
Dlg.ShowDialog(); 

) 


¿Para qué necesitamos la barra de desplazamiento? Para variar el retardo del 
temporizador entre 10x1 y 10x150 milisegundos con el fin de variar la velocidad 
de conteo. Según esto, añada a la clase DlgControlesRangoDefinido un tempori- 
zador y el controlador que responda a su evento Tick. Este método tiene que ac- 
tualizar el valor de la etiqueta etContador incrementándolo en una unidad. 


private void Temporizador_Tick(object sender, EventArgs e) 
( 

etContador.Text = (Convert.Tolnt32(etContador.Text) + 1).ToString(); 
) 


¿A intervalos de cuántos milisegundos se producirá el evento Tick? Esto es lo 
que indicará la barra de desplazamiento. Según esto, añada a la clase DlgContro- 
lesRangoDefinido un controlador de eventos ValueChanged que responda a las 
variaciones del cursor que el usuario haga sobre la barra de desplazamiento y 
complételo como se indica a continuación: 


private void bdhIntervalo_ValueChanged(object sender, EventArgs e) 
( 
Temporizador.Interval = 10 * bdhIntervalo.Value; 


} 


Como se puede observar, un objeto ScrollBar genera eventos ValueChanged 
siempre que experimenta un cambio. Lo que en realidad sucede es que al variar el 
cursor se genera un evento Scroll (evento predeterminado), se actualiza la propie- 
dad Value y, como consecuencia, se genera el evento ValueChanged. O sea, que 
podríamos haber utilizado el evento Seroll en lugar de ValueChanged para esta- 
blecer el intervalo de tiempo del temporizador. 
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El valor inicial para la propiedad Interval lo podemos establecer en el méto- 
do que responda al evento Load del formulario: 


private void DlglControlesRangoDefinido_Load(object sender, EventArgs e) 
( 

Temporizador.Interval = 10 * bdhIntervalo.Value; 
) 


TrackBar 


Un objeto TrackBar es un control deslizante o deslizador. Igual que una barra de 
desplazamiento, un deslizador, dependiendo del valor de su propiedad Orienta- 
tion (Horizontal o Vertical), puede tener orientación horizontal o vertical y, ade- 
más, se puede mejorar su apariencia con marcas. El espaciado de estas marcas 
viene determinado por la propiedad TickFrequency y su posición por TickStyle. 


Como ejemplo, vamos a modificar la caja de diálogo anterior como muestra la 
figura siguiente: 





ú 
Controles de rango definido = 





Q 


Rápido Normal Lento 

















Se puede observar que hemos cambiado la barra de desplazamiento por un 
deslizador y tres etiquetas con las siguientes propiedades: 


Deslizador Name desIntervalo 
Minimum 
Maximum 150 
Value 
LargeChange 
SmallChange 
TickFrequency 
TabStop 


Etiqueta 
Etiqueta 
Etiqueta 





206 ENCICLOPEDIA DE MICROSOFT VISUAL C# 


Cuando el usuario hace clic en el control TrackBar se genera el evento pre- 
determinado Seroll y el desplazamiento que se realiza está especificado por Lar- 
geChange. Ahora, si el usuario presiona una de las teclas de dirección, el 
desplazamiento viene especificado por SmallChange. 


Una vez finalizado el diseño, podremos observar en la clase DlgControles- 
RangoDefinido (localizada en el fichero DlgControlesRangoDefinido.Desig- 
ner.cs) el código necesario para añadir un deslizador a un diálogo: 


partial class DlgControlesRangoDefinido 


( 























1! 

private TrackBar desIntervalo; 

desIntervalo = new TrackBar(); 

desIntervalo.Name = "desIntervalo"; 
desIntervalo.Minimum = 1; 

desIntervalo.Maximum = 150; 

desIntervalo.Value = 76; 

desIntervalo.Largelhange = 30; 
desIntervalo.SmallChange = 5; 
desIntervalo.TickFrequency = 5; 

desIntervalo.TabStop = false; 

desIntervalo.Location = new System.Drawing. Point(15, 27); 
desIntervalo.Size = new System.Drawing.Size(263, 45); 
desIntervalo.TabIndex = 1; 
Controls.Add(desIntervalo); 


1/ 


Finalmente, modifique el controlador del evento ValueChanged para que 
ahora haga referencia al control desIntervalo. 


private void desIntervalo_ValueChanged(object sender, EventArgs e) 
( 
Temporizador.Interval = 10 * desIntervalo.Value; 


} 
ProgressBar 


Un objeto ProgressBar es una barra de progreso; esto es, un rectángulo de una 
longitud arbitraria, del cual, en un instante determinado, estará coloreado un tanto 
por ciento en función de la cantidad ya finalizada de un proceso por el que esta- 
mos esperando. Es una forma de indicar al usuario que una aplicación no está blo- 
queada, sino que está realizando una tarea larga. 
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Las propiedades Minimum y Maximum definen el intervalo de valores que 
representarán el progreso de una tarea. Normalmente, la propiedad Minimum se 
pone a valor 0 y Maximum al valor que indica que la tarea ha terminado. La pro- 
piedad Value representa el progreso que la aplicación realiza para terminar la 
operación. Esta propiedad se puede modificar directamente, o se puede utilizar la 
propiedad Step para especificar el valor con que se incrementará y, después, lla- 
mar al método PerformStep para incrementar ese valor, o se puede utilizar el mé- 
todo Increment. El método Increment permite incrementar el valor de la 
propiedad Value una cantidad específica; este método es similar a utilizar la pro- 
piedad Step con el método PerformStep. Su evento predeterminado es Click. 


Como ejemplo, vamos a añadir a la caja de diálogo anterior una barra de pro- 
greso, que supervise una cuenta de 0 a 1000, con las propiedades indicadas a con- 
tinuación. Cuando se alcance el valor 1000, la cuenta finalizará. Este valor podría 
corresponderse, por ejemplo, con el número de ficheros que tiene que leerse para 
instalar una determinada aplicación. 


Barra de progreso Name bpCuenta 
Minimum 
Maximum 100 





Rápido 











Obsérvese que hemos establecido como valor máximo 100 para la barra. Esto 
lo hacemos así porque la resolución de la barra es baja y, por lo tanto, habrá mu- 
chos valores entre 0 y 1000 que no hagan ningún cambio visual en la misma, pero 
sí consumen tiempo de UCP. La mejor solución es especificar la cantidad ya fina- 
lizada de un proceso en tanto por ciento, de ahí el rango 0 (cero por ciento) a 100 
(cien por cien). 


Una vez finalizado el diseño, podremos observar en la clase D/gControles- 
RangoDefinido el código necesario para añadir una barra de progreso a un diálo- 


go: 
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partial class DlgControlesRangoDefinido 
( 

LAO ae 
private ProgressBar bpCuenta; 


pCuenta = new ProgressBar(); 
pCuenta.Name = "bpCuenta”; 
pCuenta.Maximum = 100; 
pCuenta.Minimum = 0; 

pCuenta.Value = 0; 

pCuenta.Location = new System.Drawing.Point(12, 124); 
pCuenta.Size = new System.Drawing.Size(266, 19); 





QU MOFA A E 











Controls.Add(bpCuenta); 
1! 


Finalmente, modifique el controlador del evento Tick para que, además de in- 
crementar la cuenta, aumente proporcionalmente la barra de progreso: 


private void Temporizador_Tick(object sender, EventArgs e) 
( 
int inc = 1; // incremento 

int tpHecho = 0, carga = 1000; // la cuenta es hasta 1000 
int cuenta = Convert.Tolnt32(etContador.Text) + inc; 
etContador.Text = Convert.ToStringí(cuenta); 

// Mostrar progreso 
tpHecho = (int>((float)cuenta / carga * 100); 

if (tpHecho > bpCuenta.Value) bpCuenta.Value = tpHecho; 
if (cuenta == carga) Tlemporizador.Stop(); 














Control con pestañas 


Para exponer una gran cantidad de datos minimizando el uso del espacio de panta- 
lla podemos utilizar el elemento TabControl. Este objeto está compuesto de va- 
rios objetos TabPage (un elemento o página con pestaña) que comparten el 
espacio definido por TabControl y que son almacenados en la colección referen- 
ciada por su propiedad TabPages, de los cuales solo uno está visible cada vez. La 
página de fichas seleccionada actualmente está referenciada por la propiedad Se- 
lectedTab y su índice viene dado por la propiedad SelectedIndex. 


Por ejemplo, vamos a añadir al menú Diálogos de la aplicación CajasDeDia- 
logo anterior un nuevo elemento “Control de pestañas” de forma que cuando el 
usuario haga clic sobre él, se visualice una caja de diálogo como la que muestra la 
figura siguiente. La caja de diálogo será un objeto de la clase DlgControlConPes- 
tañas derivada de Form. 
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Puede configurar cada una de las páginas del control a través de su propiedad 
TabPages. También a través de esta propiedad puede agregar y quitar páginas del 
control. Para añadir controles a una página y responder a sus eventos, los pasos a 
seguir son los mismos que para cualquier otro formulario. 


Gestión de fechas 


Windows Forms incluye dos controles para manipular fechas: MonthCalendar y 
DateTimePicker. Ambos están diseñados para permitir al usuario elegir una fe- 
cha. 





+ ' 
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El control MonthCalendar muestra un calendario que visualiza un solo mes 
a la vez y permite desplazarse de mes en mes (haciendo clic en los botones de fle- 
cha) o saltar a un mes específico (haciendo clic en el encabezado de mes para ver 
todo un año, y luego haciendo clic en el mes). 
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Las propiedades MinDate y MaxDate permiten limitar la fecha y hora que se 
puede seleccionar. 


La propiedad ShowToday indica si la fecha representada por la propiedad 
TodayDate se muestra (valor true) en la parte inferior del control. 


El evento DateChanged se genera al seleccionar una fecha, ya sea mediante 
el ratón, el teclado o mediante código. El evento de DateSelected es similar, pero 
solo se genera al final de una selección mediante el ratón. Por ejemplo, el siguien- 
te código analiza el día de la semana seleccionado en el control MonthCalendar: 


private void monthCalendarl_DateChanged(object sender, _ 
DateRangeEventArgs e) 
( 
DateTime fecha = e.Start; 
if (fecha.DayOfWeek == DayOfWeek.Saturday || 
fecha.DayOfWeek == Day0fWeek.Sunday) 
{ 
etMensaje.Text = "Los fines de semana no se pueden seleccionar." ; 
) 
else 
etMensaje.Text = 


mt, 
> 


El control DateTimePicker requiere menos espacio que el MonthCalendar, 
según se puede ver en la figura anterior. Es análogo a una lista desplegable que 
cuando se abre muestra el mes actual, igual que MonthCalendar y con la misma 
funcionalidad. La fecha elegida será mostrada por la caja de texto en formato de 
fecha largo o corto. 


Muchas de las propiedades de DateTimePicker sirven para administrar su 
objeto MonthCalendar integrado y funcionan del mismo modo que la propiedad 
equivalente de MonthCalendar. 


La fecha u hora seleccionada actualmente en el control DateTimePicker vie- 
ne dada por su propiedad Value. También se puede establecer la propiedad Value 
antes de que se muestre el control (por ejemplo, en el evento Load del formulario) 
para fijar la fecha seleccionada inicialmente en el control; el valor predeterminado 
es la fecha actual. Cuando cambia la propiedad Value se genera el evento Va- 
lueChanged. La propiedad Value devuelve como valor una estructura DateTime. 


FlowLayoutPanel y TableLayoutPanel 


FlowLayoutPanel organiza su contenido para que fluya horizontalmente o verti- 
calmente. La dirección del flujo se especifica estableciendo su propiedad FlowDi- 
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rection a uno de estos valores: BottomUp, LefiToRight, RightToLeft y TopDown,; 
el valor predeterminado es LeftToRight: los elementos fluyen del borde izquierdo 
de la superficie de diseño al borde derecho. Y el contenido del control puede ajus- 
tarse o recortarse estableciendo su propiedad WrapContents (true si debe ajus- 
tarse; false en caso contrario); el valor predeterminado es true. Así mismo, la 
propiedad AutoSecroll, cuando vale true, permite que el usuario se desplace a los 
controles situados fuera de los límites visibles. 


El contenido de un control FlowLayoutPanel será otros controles Windows 
Forms, incluyendo el propio control FlowLayoutPanel, lo que permitirá crear di- 
seños sofisticados que se adapten durante la ejecución a las dimensiones de su 
formulario. La idea es disponer de un formulario con un contenido que se organi- 
ce a sí mismo apropiadamente en función de que cambie su tamaño o el tamaño 
del contenido. 


La regla general para la delimitación y el acoplamiento de los controles se- 
cundarios en el control FlowLayoutPanel es la siguiente: para direcciones de flu- 
jo verticales, el control FlowLayoutPanel fija una columna implícita de ancho 
igual al ancho del control secundario más ancho de esa columna. Esto quiere decir 
que todos los demás controles de esta columna que fijen sus propiedades Anchor 
o Dock se alinearán o se ajustarán para adaptarse a esta columna implícita. Para 
las direcciones de flujo horizontales el comportamiento es análogo, pero con res- 
pecto a la altura; esto es, el control FlowLayoutPanel fija una fila implícita de al- 
to igual al alto del control secundario más alto de la fila, y todos los controles 
secundarios delimitados o acoplados de esta fila se alinean o se cambian de tama- 
ño para ajustarse a la fila implícita. 


Puede probar lo expuesto añadiendo a un formulario un control FlowLayout- 
Panel acoplado (propiedad Dock igual a Fil!) con la intención de organizar el 
contenido verticalmente, colocando dos botones sobre dicho control, establecien- 
do el ancho (Width) del primer botón en un valor determinado (utilice un valor 
que sea mayor que el ancho del segundo botón) y acoplando (Dock) el segundo 
botón. Después de estas operaciones observará que el segundo botón adquiere un 
ancho igual al del primero; esto es, el segundo botón se acopla a esa columna im- 
plícita fijada por el ancho del primer botón. 


Análogamente, un control TableLayoutPanel organiza su contenido en una 
cuadrícula, proporcionando una funcionalidad similar al elemento <table> de 
HTML. Las celdas se organizan en filas y columnas y estas pueden tener distintos 
tamaños. Para más detalles recurra a la ayuda proporcionada por MSDN. 


Por ejemplo, vamos a añadir al menú Diálogos de la aplicación CajasDeDia- 
logo anterior un nuevo elemento “Panel de diseño” de forma que cuando el usua- 
rio haga clic sobre él, se visualice una caja de diálogo como la que muestra la 
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figura siguiente. La caja de diálogo será un objeto de la clase DlgPanelDeDiseño 
derivada de Form y mostrará una lista de elementos que serán cajas de texto con 
el contenido que se quiere mostrar (esta lista estará inicialmente vacía), y tres bo- 
tones más una caja de texto. El botón: 


e Aceptar mostrará el contenido del elemento de la lista seleccionado. 

e Añadir agregará un nuevo elemento al final de la lista con el contenido de la 
caja de texto que hay debajo de este botón. 

e Borrar eliminará de la lista el elemento seleccionado. 


SS 
a9 Panel de diseño 3ml 
uno s | Aceptar 
d 
: 
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De acuerdo con el planteamiento del problema, pasamos a diseñar esa caja de 
diálogo con los controles y propiedades que se especifican en la tabla siguiente: 


Caja de diálogo Name DlgPanelDeDiseño 
Text Panel de diseño 
FormBorderStyle FixedDialog 
MinimizeBox False 
MaximizeBox False 

StartPosition CenterParent 
Panel de diseño Name flpLista 
FlowLayoutPanel AutoScroll True 


BorderStyle FixedSingle 
Botón de pulsación 





FlowDirection TopDown 
WrapContents False 


“ 
Text &Aceptar 
Text Aña&dir 
Text 


(nada) 
Text &Borrar 
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Una vez finalizado el diseño, podremos observar que se ha añadido a la apli- 
cación una nueva clase DlgPanelDeDiseño a partir de la cual podremos crear ese 
tipo de cajas de diálogo. A continuación puede ver el código necesario para añadir 
un panel de diseño de tipo FlowLayoutPanel: 


partial class DlgPanelDeDiseño 
( 
1! 
private System.Windows.Forms.FlowLayoutPanel flpLlista; 


flpLista = new FlowLayoutPanel(); 


ta.Name = "flpLista"; 

ta.AutoScroll = true; 

ta.BorderStyle = BorderStyle.FixedSingle; 
ta.FlowDirection = FlowDirection.TopDown; 
.WrapContents = false; 

ta.Location = new System.Drawing.Point(13, 10); 
ta.Size = new System.Drawing.Size(176, 143); 
ta.TabIndex = 4; 
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.Add(flplista); 
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Para mostrar este diálogo desde el menú Diálogos de la clase CajasDeDialo- 
go, añada al mismo la orden correspondiente. 


Veamos qué operaciones tiene que realizar el controlador del botón Añadir. 
Este botón agregará un nuevo elemento de tipo TextBox al final de la lista con el 
contenido de la caja de texto, ctARadir, que hay debajo de este botón. 


private void btAñadir_Click(object sender, EventArgs e) 
( 
if (ctAñadir.Text.Length != 0) 
( 
TextBox elemento = new TextBox():; 
elemento.Click += textBox_Click; // controlador del evento Click 
elemento.Width = flpLista.Width - 28; 
elemento.Text = ctAñadir.Text; 
// Añadir el elemento a la lista 
flplLista.Controls.Add(elemento); 
) 








} 


private void textBox_Click(object sender, EventArgs e) 
{ 
ctEnfocada = sender as TextBox; 


} 
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Obsérvese en el código anterior que cada nuevo elemento TextBox añadido al 
control FlowLayoutPanel es vinculado con el controlador que responderá a su 
evento Click, encargado de guardar la referencia a dicho elemento en el atributo 
privado ctEnfocada de la clase DlgPanelDeDiseño, con el fin de seguir la pista al 
elemento actualmente seleccionado. Defina este atributo así: 


private TextBox ctEnfocada = null; 


El botón Aceptar muestra el texto del elemento actualmente seleccionado (úl- 
timo elemento sobre el que se hizo clic): 


private void btAceptar_Click(object sender, EventArgs e) 
( 
if (ctEnfocada != null) 
MessageBox.Show(ctEnfocada.Text); 


Y el botón Borrar elimina de la lista el elemento actualmente seleccionado: 


private void btBorrar_Click(object sender, EventArgs e) 
( 

flpLista.Controls.Remove(ctEnfocada):; 

ctEnfocada = null; 


En este ejemplo, los elementos de la lista construida a partir del control Flow- 
LayoutPanel son de tipo TextBox, pero, evidentemente, pueden ser de cualquier 
otro tipo, incluso de un tipo definido por el usuario (véase el capítulo Construc- 
ción de controles). 


CAJAS DE DIÁLOGO ESTÁNDAR 


La biblioteca .NET incluye una serie de clases, derivadas todas ellas de Com- 
monDialog y definidas en el espacio de nombres System.Windows.Forms, que 
permiten visualizar las cajas de diálogo más comúnmente empleadas en el diseño 
de aplicaciones, tales como la caja de diálogo Abrir (Open) o Guardar (Save) y la 
caja de diálogo Color (Color). Estas clases son las siguientes: 


Clase Descripción 

ColorDialog Representa una caja de diálogo que muestra los colores 
disponibles, y también permite a los usuarios definir colo- 
res personalizados. 


FileDialog Es una clase abstracta que representa una caja de diálogo 
en la que el usuario puede seleccionar un fichero. De ella 
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se derivan las clases OpenFileDialog y SaveFileDialog, 
que son las que tendremos que utilizar para crear una caja 
de diálogo en la que el usuario pueda abrir o guardar un 
fichero, respectivamente. 


FolderBrowserDialog Representa una caja de diálogo que permite al usuario se- 
leccionar una carpeta. 


FontDialog Representa una caja de diálogo que muestra una lista con 
las fuentes que normalmente se instalan en el sistema. 


PageSetupDialog Representa una caja de diálogo que permite manipular la 
configuración de una página, incluidos los márgenes y la 
orientación del papel. 


PrintDialog Permite a los usuarios seleccionar una impresora y elegir 
qué partes del documento se deben imprimir. 


Para ver cómo se utilizan estas cajas de diálogo, añada al menú Archivo de la 
aplicación CajasDeDialogo dos nuevas órdenes, Abrir y Guardar; la primera de- 
be mostrar la caja de diálogo estándar Abrir y la segunda la de Guardar. Después, 
añada al menú Diálogos la orden Color, esta orden debe mostrar la caja de diálo- 
go Color, y la orden Fuente para mostrar la caja de diálogo Fuente. Como resul- 
tado mostraremos, en todos los casos, una caja de diálogo predefinida con la 
elección realizada. 


Cajas de diálogo Abrir y Guardar 


La caja de diálogo Abrir permite al usuario seleccionar una unidad de disco, un 
directorio, una extensión de fichero y un nombre de fichero. Una vez realizada la 
selección, la propiedad FileName de la caja de diálogo contiene el nombre com- 
pleto del fichero elegido. 


Para visualizar la caja de diálogo Abrir: 
Creamos un objeto de la clase OpenFileDialog. 


Modificamos los valores por omisión de sus propiedades, si es necesario. 
3. Mostramos el diálogo invocando a ShowDialog. 


Mire 


El valor de tipo DialogResult devuelto por ShowDialog indica si el usuario 
aceptó la operación (OK) o la canceló (Cancel). 
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De acuerdo con lo expuesto, el método asociado con la orden Abrir del menú 


Archivo puede ser el siguiente: 


private void ArchivoAbrir_Click(object sender, EventArgs e) 


{ 
OpenFileDialog DIgAbrir = new OpenFileDialog(); 


DlgAbrir.ShowReadOnly = true; 
DlgAbrir.InitialDirectory = "c:\WW'; 


DlgAbrir.Filter = "ficheros txt (*.txt)|*.txt|Todos (*.*)|*.*"; 


DlgAbrir.FilterIndex = 2; 
DlgAbrir.RestoreDirectory = true; 

// Mostrar el diálogo Abrir 

if (DlgAbrir.ShowDialog() == DialogResult.OK) 
{ 














// Si Read0nlyChecked es true, utilizar OpenFile para 
// abrir el fichero solo para leer 
if (DlgAbrir.ReadOnlyChecked) 
( 
Stream fs = DlgAbrir.OpenFile(); 
// Código para trabajar con el fichero 
1/ 


MessageBox.Show(DlgAbrir.FileName); 
} 


else // En otro caso, abrir el fichero para leer y escribir 


{ 
string ruta = DlgAbrir.FileName; 
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FileStream fs = new FileStream(ruta, FileMode.Open, 
FileAccess.ReadWrite); 

// Código para trabajar con el fichero 

LE Ea 

MessageBox.Show(DlgAbrir.FileName); 


El método OpenFile de la clase OpenFileDialog abre el fichero seleccionado 
por el usuario con permiso de solo lectura y Close lo cierra. La propiedad File- 
Name especifica el nombre de ese fichero incluyendo la ruta de acceso. 


La propiedad ShowReadOnly indica si la caja de diálogo contiene una casilla 
de verificación de solo lectura, InitialDirectory especifica el directorio inicial 
que muestra la caja de diálogo, Filter especifica la cadena actual del filtro de 
nombres de fichero que da lugar a las opciones que aparecen en la lista “Tipo” del 
diálogo, FilterIndex especifica el índice del filtro actualmente seleccionado en el 
diálogo y RestoreDirectory especifica un valor que indica si la caja de diálogo 
restablece el directorio actual (valor de System.Environment.CurrentDirectory) 
a su valor original si el usuario cambió el directorio mientras buscaba ficheros an- 
tes de cerrarse. 


La caja de diálogo Guardar es idéntica a la caja de diálogo Abrir (solo cam- 
bia Abrir por Guardar). El siguiente método asociado con la orden Guardar del 
menú Archivo muestra esta caja de diálogo invocando a ShowDialog: 


private void ArchivoGuardar_Click(object sender, EventArgs e) 
( 

Stream fs; 

SaveFileDialog DlgGuardar = new SaveFileDialog(); 


DlgGuardar.Filter = "ficheros txt (*.txt)|*.txt|Todos (*.*)|*.*"; 
lgGuardar.Filterlndex = 2; 
DlgGuardar.RestoreDirectory = true; 


(e 








if (DlgGuardar.ShowDialog() == DialogResult.0K) 
{ 
// Abrir el fichero para leer y escribir 
fs = DligGuardar.OpenFile(); 
if (fs != null) 
{ 
// Código para trabajar con el fichero 
AET 
fs.Close(); 
) 
) 
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El método OpenFile de la clase SaveFileDialog abre el fichero seleccionado 
por el usuario con permiso de lectura y escritura. En cambio, para la clase Open- 
FileDialog lo abre solo para lectura. 


Caja de diálogo Color 


La caja de diálogo Color permite al usuario seleccionar un color de una paleta o 
crear y seleccionar un color personalizado. La figura siguiente muestra el aspecto 
de este diálogo: 


Y 
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Para visualizar la caja de diálogo Color: 


Creamos un objeto de la clase ColorDialog. 
Modificamos los valores por omisión de sus propiedades, si es necesario. 
3. Mostramos el diálogo invocando al método ShowDialog. 


N e 


El valor de tipo DialogResult devuelto por ShowDialog indica si el usuario 
aceptó la operación (OK) o la canceló (Cancel). 


De acuerdo con lo expuesto, añada una caja de texto a Forml y el controlador 
de eventos Click para la orden Color del menú Diálogos. Después, complete este 
controlador como se indica a continuación. La intención es que el usuario pueda 
modificar el color del texto de la caja de texto con el color seleccionado del diálo- 
go Color. 


private void DialogoColor_Click(object sender, EventArgs e) 
( 
ColorDialog Dlglolor = new ColorDialog(); 
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// Seleccionar inicialmente el color actual del texto 
Dlglolor.Color = TextBox1.ForeColor; 
// Actualizar el color del texto de TextBoxl 
if (DlgColor.ShowDialog() == DialogResult.OK) 
( 
TextBox1.Forelolor = DlgColor.Color; 
) 


La propiedad Color especifica el color seleccionado por el usuario. Cuando 
se abra el diálogo Color, aparecerá inicialmente seleccionado el color indicado 
por esta propiedad, o el negro si a esta propiedad no se le asigna un valor. Otras 
propiedades son AllowFullOpen, que indica si el usuario puede utilizar la caja de 
diálogo para definir colores personalizados; o ShowHelp, que indica si aparecerá 
el botón Ayuda en el cuadro de diálogo Color. 


En el código anterior se puede observar que el método ShowDialog muestra 
el diálogo Color que inicialmente visualizará seleccionado el color actual del tex- 
to de TextBox1. Una vez mostrado este diálogo, el usuario elegirá otro que será 
almacenado en la propiedad Color del diálogo y aplicado a TextBox1 como nuevo 
color del texto. 


Caja de diálogo Fuente 


La caja de diálogo Fuente permite al usuario seleccionar una fuente de una lista y 
fijar el estilo, el tamaño y otras características. La figura siguiente muestra el as- 
pecto de este diálogo: 





F 


























Fuente 

Fuente: Estilo de fuente: Tamaño: 
Normal 7 
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Para visualizar la caja de diálogo Fuente: 


ha 


Creamos un objeto de la clase FontDialog. 
2. Modificamos los valores por omisión de sus propiedades, si es necesario. 
Mostramos el diálogo invocando al método ShowDialog. 


w 


El valor de tipo DialogResult devuelto por ShowDialog indica si el usuario 
aceptó la operación (OK) o la canceló (Cancel). 


De acuerdo con lo expuesto, añada el controlador de eventos Click para la or- 
den Fuente del menú Diálogos. Después, complete este controlador como se indi- 
ca a continuación. 


s 


private void DialogofFuente_Click(object sender, EventArgs e) 
( 
FontDialog DlgFuente = new FontDialog():; 

// Mostrar la lista para la elección del color 
DlgFuente.ShowColor = true; 

// Seleccionar inicialmente la fuente y el color actual del texto 
DlgFuente.Font = TextBox1.Font; 


DlgFuente.Color = TextBox1.ForeColor; 











if (DI 
( 


«O 


Fuente.ShowDialog() == DialogResult.O0K) 





// Actualizar la fuente y el color del texto 
TextBox1.Font = DlgFuente.Font; 
TextBox1.ForeClolor = DlgFuente.Color; 





La propiedad Font permite obtener la fuente actual o establecer la fuente se- 
leccionada, la propiedad ShowColor especifica si la caja de diálogo muestra una 
lista para elegir el color del texto, y la propiedad Color especifica el color selec- 
cionado por el usuario para el texto. 


En el código anterior se puede observar que el método ShowDialog muestra 
el diálogo Fuente que inicialmente visualizará la lista para la elección del color y 
la fuente actual, así como sus características, del texto de TextBox1. Una vez mos- 
trado este diálogo, el usuario elegirá la nueva fuente, así como sus características, 
que serán almacenadas en las propiedades Font y Color del diálogo y aplicadas a 
TextBoxl. 
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REDIMENSIONAR UN COMPONENTE 


En ocasiones puede ser necesario modificar el tamaño o la posición de un objeto 
durante la ejecución. La primera operación puede realizarse por medio de la pro- 
piedad Size y la segunda por Location. 


Cuando se modifica el tamaño de una ventana, se producen los eventos Resi- 
ze y SizeChanged, y cuando se modifica la posición de un objeto se produce el 
evento LocationChanged. 


En ocasiones también puede ser necesario que los controles se ajusten en fun- 
ción del tamaño de la ventana. Por ejemplo, un control puede acoplarse a los cua- 
tro bordes del marco de la ventana, a uno de ellos o a ninguno. Esto se hace por 
medio de la propiedad Dock que puede tomar los valores siguientes: 


DockStyle.Bottom. El control se acopla al borde inferior del formulario. 
DocksStyle.Fill. El control se acopla a todos los bordes del formulario, llenando 
todo el espacio. 

DockStyle.Left. El control se acopla al borde izquierdo del formulario. 
DockStyle.None. No se acopla a ningún borde. 

DockStyle.Right. El control se acopla al borde derecho del formulario. 
DockStyle.Top. El control se acopla al borde superior del formulario. 


Otras veces interesa que al modificar el tamaño de una ventana, sus controles 
varíen en la misma dirección conservando sus posiciones. Por ejemplo, que varíen 
su tamaño a lo ancho y conservando su posición si se trata de una caja de texto, a 
lo ancho y a lo alto y conservando su posición si se trata de una lista, o simple- 
mente conservado su posición si se trata de un botón. Este efecto se consigue por 
medio de la propiedad Anchor de cada control. 


La propiedad Anchor permite anclar cualquiera de los bordes de un control 
(Top — superior, Left — izquierdo, Bottom — inferior y Right — derecho) al borde 
respectivo de su contenedor. Por ejemplo, suponga una caja de texto situada en la 
parte inferior de un formulario. Si queremos que al redimensionar el formulario 
sus bordes izquierdo, inferior y derecho conserven la distancia con los bordes res- 
pectivos de su contenedor (a costa de variar su ancho), tenemos que anclar estos 
bordes a los del contenedor, lo que supone: 


textBox1.Anchor = (AnchorStyles) 
(AnchorStyles.Bottom | AnchorStyles.Left) | AnchorStyles.Right); 
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TEMPORIZADORES 


Supongamos que deseamos realizar una aplicación que muestre un reloj digital 
similar al de la figura siguiente. Evidentemente, la ventana mostrará en todo mo- 
mento la hora actual. Esto nos exigirá utilizar un temporizador. 





20:01:33 








Un temporizador se corresponde con un objeto que notifica periódicamente a 
la aplicación que lo crea cuándo ha transcurrido un período predeterminado de 
tiempo. Cada vez que transcurre el período de tiempo especificado cuando se creó 
el temporizador, el objeto genera un evento “tiempo transcurrido” y espera una 
respuesta por parte de la aplicación que lo creó. 


Hay tres temporizadores (objeto de la clase Timer) en Visual Studio: 


e El temporizador estándar basado en Windows. Pertenece al espacio de nom- 
bres System.Windows.Forms. Es el temporizador tradicional y está optimi- 
zado para su utilización en aplicaciones de formularios Windows. 


e El temporizador basado en servidor. Pertenece al espacio de nombres Sys- 
tem.Timers. Es una actualización del temporizador tradicional optimizada 
para ejecutarse en un entorno de servidor. Da mayor precisión que la propor- 
cionada por los temporizadores de Windows. 


e El temporizador de subprocesos. Pertenece al espacio de nombres Sys- 
tem.Threading. Es un temporizador sencillo y ligero que utiliza métodos de 
devolución de llamada en lugar de eventos y se ejecuta a través de subproce- 
sos. Está disponible solo mediante programación. 


Para instalar un temporizador en una aplicación, siga los pasos especificados 
a continuación: 
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1. Cree un objeto de la clase Timer. Para ello, arrastre desde la ficha Compo- 
nentes de la caja de herramientas el control Timer. El asistente generará el 
código siguiente: 


private System.Windows.Forms.Timer Temporizador; 
// 

Temporizador = new System.Windows.Forms.Timer(); 
1! 
Temporizador.Interval = 1000; 
Temporizador.Enabled = true; 





La propiedad Interval es el intervalo de tiempo en milisegundos que tiene 
que transcurrir para que el objeto genere un evento Tick (el tiempo pasó) in- 
dependientemente de las acciones del usuario (Elapsed si el temporizador es 
de la clase System.Timers). La propiedad Enabled cuando su valor es true 
hace que se generen eventos Tick cada vez que transcurre el intervalo de 
tiempo establecido. 


Establecer la propiedad Enabled a true es lo mismo que llamar al método 
Start, y establecerla a false es lo mismo que llamar al método Stop. 


2. Agregue un controlador para manejar el evento Tick. Para ello, haga doble 
clic sobre el temporizador. El código que se añade es el siguiente: 


private void Temporizador_Tick(object sender, EventArgs e) 
( 

// 
) 


Ahora, cada vez que el temporizador genera un evento Tick la aplicación res- 
ponderá ejecutando el método Temporizador_Tick. 


Tenga en cuenta que en órdenes de unos pocos milisegundos (o microsegun- 
dos, dependiendo de su sistema hardware, sistema operativo, máquina virtual de 
.NET, API de .NET, etc.) y en ámbitos normales de ejecución, el retardo progra- 
mado podrá no cumplirse si está por debajo de lo que su sistema en ese momento 
puede soportar como valor mínimo. Para conocer este valor puede realizar un test 
a su máquina añadiendo a la clase que define el formulario el código siguiente: 


public partial class Dlglemporizador : Form 

( 
private TimeSpan tAntes; 
private TimeSpan tDespues; 





public DlgTemporizador() 
( 
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Eh 


nitializeComponent(); 


private void Dlglemporizador_Load(object sender, EventArgs e) 


tAntes = DateTime.Now.Time0fDay; 
Temporizador. Interval = 1; // milisegundo 








private void Temporizador_Tick(object sender, EventArgs e) 
( 
tDespues = DateTime.Now.Time0fDay; 
Debug.WriteLine((tDespues - tAntes).Milliseconds + 
tAntes = tDespues; 


mseg.”); 


En el código anterior se puede observar que el método que responde al evento 
Load del formulario toma la hora actual (con una precisión de microsegundos) 
almacenándola en un objeto TimeSpam (un objeto TimeSpam representa un in- 
tervalo de tiempo) e inicia la propiedad Interval a 1 milisegundo, tiempo que tie- 
ne que transcurrir para que el temporizador genere un evento Tick. Después, cada 
vez que Temporizador Tick responde a este evento, se muestra el tiempo en mili- 
segundos que ha transcurrido, que lógicamente estará por encima del programado. 
Ese valor será su resolución máxima. 


Cuando una aplicación termine con el temporizador, es bueno llamar a su mé- 
todo Stop para detener la generación de los eventos de acción. 


Tenga también presente que, si su aplicación u otra aplicación está realizando 
una tarea que mantiene ocupados los recursos del ordenador por un espacio largo 
de tiempo, tal como un bucle largo, cálculos intensivos, acceso a los puertos, etc., 
puede ser que no responda de acuerdo con los intervalos de tiempo programados. 


Después de esta exposición, para escribir la aplicación propuesta, simplemen- 
te tendrá que realizar los pasos siguientes: 


1. Añada un nuevo diálogo DlgTemporizador a la aplicación CajasDeDialogo 
con una etiqueta etHora (objeto de la clase Label): 


private Label etHora; 
etHora = new Label(); 

1! 

etHora.Name "etHora"; 
etHora.Text = "00:00:00"; 
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etHora.AutoSize = true; 

etHora.Font = new Font("Microsoft Sans Serif", 24F, 
FontStyle.Regular, GraphicsUnit.Point, ((byte)(0))); 
etHora.Location = new Point(75, 100); 

etHora.Size = new Size(143, 37); 

etHora.Tablndex = 0; 

Js 
Controls.Add(etHora):; 








2. Añada un control Timer y asígnele como nombre Temporizador. 


3. Añada el controlador que responda a los eventos Tick del temporizador y 
complételo como se indica a continuación. 


private void Temporizador_Tick(object sender, EventArgs e) 
( 

etHora.Text = DateTime.Now.ToLonglimeString(); // hora actual 
) 


Compile la aplicación, ejecútela y pruebe los resultados. 


EJERCICIOS RESUELTOS 


Supongamos que queremos construir una pequeña base de datos para llevar la 
cuenta de los libros de nuestra biblioteca particular, de los cuales, en ocasiones, 
prestamos algunos a otras personas. Para seguir la pista a estos libros, vamos a re- 
gistrar en esa base los siguientes datos: título de libro, autor, editorial y datos so- 
bre el préstamo. Cada uno de estos datos elementales se denomina campo, y el 
conjunto de todos los campos referentes a un mismo libro recibe el nombre de re- 
gistro. 


Nuestra aplicación va a constar de una ventana principal que permita introdu- 
cir o visualizar los datos de un registro y de un menú que permita, entre otras co- 
sas, buscar un determinado registro. Cuando el usuario seleccione en este menú la 
orden “Buscar registro...”, aparecerá una caja de diálogo con una lista ordenada de 
los títulos de los libros prestados. Cuando el usuario seleccione uno de los títulos 
y haga clic en el botón Aceptar, los datos correspondientes a ese libro se visuali- 
zarán en la ventana principal. 


Generalmente, una base de datos está ordenada por alguno de sus campos, en 
nuestro caso lo va a estar por el campo “Título”. Este objetivo lo conseguiremos 
insertando ordenadamente en la base de datos cada nuevo registro que creemos. 


Para empezar, cree el esqueleto para una nueva aplicación que utilice un for- 
mulario de la clase Form como ventana principal. Denomínela Libros. Después, 
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añada a la misma los componentes indicados en la tabla siguiente. Esta aplicación 
se encuentra en la carpeta Cap06|Resueltos|Libros del CD. 


Barra de menús 


Menú Archivo 
Añadir registro 
Buscar registro... 


Caja de texto ame 
nchor 

Caja de texto Name 
nchor 

Caja de texto Name 
nchor 


Caja de Texto 
multilínea 


ame 

Text 

Text 

Name 

Text 

Name 

Text 
N 
A 
Name 
Text 
A 
Name 
Text 
A 

Name 

Text 





Name 
Multiline 
AcceptsReturn 
ScrollBars 
Anchor 








Libros prestados 

S£ Archivo 

Añadir registro 

&Buscar registro 

Salir 

etTitulo 

Título: 

ctTitulo 

Left, Top, Right 

etAutor 

Autor: 

ctAutor 

Left, Top, Right 

etEditorial 

Editorial: 

ctEditorial 

Left, Top, Right 

etPrestado 

Prestado: 

ctPrestado 

true 
true 
Vertical 
Left, Top 


, Right, Bottom 


Obsérvese que se ha establecido la propiedad Anchor de las cajas de texto pa- 
ra que al variar el tamaño de la ventana permanezcan ancladas a los lados de inte- 
rés de la ventana y su tamaño cambie en el sentido deseado. 


Una vez finalizado el diseño, el resultado puede ser similar al mostrado en la 


figura siguiente: 
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> 


al Libros prestados ale) 





Archivo 





Título: | 
Autor 


Editorial: 


Prestado 

















También, finalizado el diseño, podremos observar en la clase Form1 (locali- 
zada en el fichero Form1.Designer.cs) el código necesario para construir los con- 
troles que muestra la figura anterior: 


partial class Forml 
( 

// 
) 


Compile y ejecute la aplicación, pruebe a introducir datos en las cajas y ob- 
serve cómo al utilizar la tecla Tab para desplazarse de una caja a otra, el texto de 
la caja que recibe el foco no queda automáticamente seleccionado, lo que facilita- 
ría la sustitución del mismo por otro texto nuevo. Para que esto suceda, tendremos 
que añadir a cada caja de texto controladores para los eventos Enter y Mou- 
seClick. En nuestro caso, estos controladores serán los mismos para todas las ca- 
jas. Por ejemplo, para el evento Enter sería así (ídem para MouseClick): 


private void Cajalexto_Enter(object sender, EventArgs e) 
( 
TextBox ObjlextBox = (TextBox)sender; 
ObjTextBox.SelectAll(); 
) 


Lo que hace este método es obtener el identificador de la caja de texto que ob- 
tiene el foco y enviarle el mensaje SelectAll. El método SelectAll selecciona todo 
el texto de la caja de texto. 


A continuación, vamos a escribir el código correspondiente a la orden Añadir 
registro del menú Archivo. Cuando el usuario haga clic en esta orden, deseará que 
el contenido actual de las cajas de texto sea almacenado en nuestra base de datos. 
Esta base de datos estará formada por una colección de registros de la clase Libro 
clasificados por el título, almacenados en un objeto SortedList. Esta clase, que 
escribiremos a continuación, definirá tantos atributos como cajas de texto apare- 
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cen en el formulario Forml, así como los métodos necesarios para manipularlos. 
Añada esta clase a la aplicación y declárela seriable para que en un futuro los ob- 
jetos de la misma se puedan guardar en el disco. Para ello, haga clic con el botón 
secundario del ratón en el nombre del proyecto y seleccione Añadir > Clase: 


[Serializable()] 
public class Libro 
( 





private string sTitulo; 
private string sAutor; 
private string sEditorial:; 
private string sPrestado; 


public Libro() ( ) 








public Libro(string título, string autor, 

string editorial, string prestado) 

( 
sTitulo = título; 
sAutor = autor; 
sEditorial = editorial; 
sPrestado = prestado; 

) 





public string ObtenerTitulo() 
( 
return sTitulo; 


) 


public void AsignarTitulo(string título) 
( 





sTitulo = título; 
) 


2! 


public override string ToString() 
( 


return sTitulo; 
) 
) 


Como sabemos, la clase Libro se deriva, por omisión, de la clase Object, de 
la cual hereda el método ToString. Este método retorna un objeto String que al- 
macena el nombre del espacio de nombres de la clase del objeto, seguido del 
nombre de la clase. Por ejemplo: Libros.Libro. 


Esto es, el método ToString de un objeto de cualquier clase, cuando no ha si- 
do redefinido, devuelve un String que indica el objeto del que se trata. Por eso, 
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cuando se escribe una clase, se recomienda redefinir este método. Se puede ob- 
servar que en la clase Libro se ha redefinido para que devuelva el atributo título 
del libro. 


Añada ahora el atributo listaLibros de la clase System.Collections.Generic.- 
SortedList a Form] para hacer referencia a nuestra base de datos. Después, cuan- 
do se cargue este formulario (evento Load), asigne a este atributo un nuevo objeto 
SortedList iniciado con cero elementos: 


public partial class Forml : Form 
( 
private Sortedlist<string, libro» l1stallbibros; 


1! 


private void Forml_Load(object sender, EventArgs e) 
( 
listalibros = new SortedList<string, Libro>(); 
) 
) 


Un objeto SortedList es una colección de pares clave-valor ordenados por la 
clave y accesibles por clave y por índice, a la que se pueden añadir elementos uti- 
lizando el método Add(c/ave, valor), obtenerlos utilizando la propiedad 
Item(c/ave) o eliminarlos utilizando el método Remove(c/ave) o el método Re- 
moveAt(índice). En el código anterior se puede observar que la clave será un ob- 
jeto string y el valor un objeto Libro. 


Para acceder a un objeto SortedList utilizando la instrucción foreach se ne- 
cesita el tipo de cada elemento de la colección. Puesto que cada elemento de Sor- 
tedList es un par clave-valor, el tipo del elemento no se corresponde con el tipo 
de la clave o del valor. En su lugar, el tipo del elemento es KeyValuePair. Se tra- 
ta de una estructura genérica que define un par clave-valor al que se puede acce- 
der mediante las propiedades Key y Value, respectivamente. Por ejemplo: 


string clave; 
Libro objetoLibro; 


foreach (KeyValuePair<string, Libro> elemento in listaLibros) 
( 

clave = elemento.Key; 

objetoLibro = elemento.Value; 

1! 
) 


Continuando con la aplicación, añada a la clase Form? un método público 
ObtenerDatos para acceder a la lista: 
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public SortedList<string, Libro> ObtenerDatos() 
( 
return listalibros; 


} 


Obsérvese que la clase Libro se ha declarado pública. Si hubiera olvidado este 
detalle, al compilar la aplicación obtendría un error por incoherencia de accesibi- 
lidad, ya que el tipo de valor devuelto (nos referimos a la clase Libro) es menos 
accesible que el método ObtenerDatos, por lo que este método no puede exponer 
el tipo Libro fuera del proyecto a través de la clase Form1. Por lo tanto, la clase 
Libro tiene que ser pública. 


Así mismo, cuando el usuario pulse la orden Añadir registro, los datos intro- 
ducidos en las cajas de texto del diálogo Libros prestados tienen que ser almace- 
nados en /listaLibros. Para ello, añada un controlador de eventos Click para la 
orden Añadir registro y complételo como se indica a continuación: 


private void ArchivoAñadirReg_Click(object sender, EventArgs e) 
( 
if (ctTitulo.Text.Length == 0) 
( 
MessageBox.Show("El campo título no puede estar vacío"); 
return; 


) 


Libro unLibro = new Libro(ctTitulo.Text, ctAutor.Text, 
ctEditorial.Text, ctPrestado.Text):; 


// Insertar el objeto Libro en orden ascendente según el título 
try 
( 








listalibros.Add(ctTitulo.Text, unLibro); 
R (ArgumentException ex) 
l MessageBox.Show(ex.Message); // probablemente la clave ya existe 
) 


La primera parte de este método verifica que la caja de texto ctTitulo no esté 
vacía y la segunda construye un objeto Libro con los datos de las cajas de texto y 
lo añade al objeto SortedList en orden ascendente según el título (primer argu- 
mento de Add). 


Siguiendo con nuestra aplicación, el paso siguiente es añadir la caja de diálo- 
go que se tiene que visualizar cuando se ejecute la orden Buscar registro del me- 
nú Archivo. Este diálogo tendrá el aspecto siguiente: 


CAPÍTULO 6: CONTROLES Y CAJAS DE DIÁLOGO 231 





[< 
al Buscar registro Sao El | 


| Cancelar 








| Borar | 




















Para ello, añada a la aplicación una nueva clase denominada DlgBuscarReg, 
derivada de Form, que permita crear un diálogo no modal con el título “Buscar 
registro” y con los controles que se observan en la figura y que se describen en la 
tabla siguiente: 


Caja de diálogo Name DlgBuscarReg 
Text Buscar registro 
FormBorderStyle FixedDialog 
MaximizeBox False 
MinimizeBox False 
StartPosition CenterParent 


Botón de pulsación Name btAceptar 

e 
Text &Cancelar 

Botón de pulsación Name btBorrar 

nn a 








Una vez finalizado el diseño de la caja de diálogo, haga que el botón Aceptar 
sea el botón predeterminado. Para ello, asigne a la propiedad AcceptButton de 
DlgBuscarReg el valor btAceptar. Asigne también a la propiedad CancelButton 
de DlgBuscarReg el valor btCancelar. 


Este diseño ha dado lugar a que el asistente para diseño de formularios haya 
añadido a la aplicación una nueva clase DlgBuscarReg (puede obtener el código 
completo de la aplicación en la carpeta Cap06lResueltos|Libros del CD que 
acompaña al libro): 


partial class DlgBuscarReg 
( 

PA gg 
) 
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Escribamos ahora el código para la orden Buscar registro del menú Archivo. 
Cuando el usuario haga clic en esta orden, queremos que se visualice la caja de 
diálogo no modal que muestra la figura siguiente. Para ello, vincule con dicha or- 
den un controlador de eventos Click y complételo como se indica a continuación: 


private void ArchivoBuscarReg_Click(object sender, EventArgs e) 
( 
DlgBuscar = new DlgBuscarReg(); 
if (!DlgBuscar.Visible) 
DlIgBuscar.Show(this); // this es el propietario (Owner) de DlgBuscar 


El método anterior crea un diálogo de la clase DlgBuscarReg y lo muestra 
invocando al método Show, pasando como argumento el formulario (this) desti- 
nado a ser propietario de ese diálogo; este valor será almacenado en la propiedad 
Owner del diálogo DlgBuscarReg. Esto hace a Forml propietario de DlgBuscar- 
Reg, lo que nos permitirá establecer posteriormente una comunicación entre am- 
bos. Un formulario que es propiedad de otro no se muestra nunca detrás de su 
propietario y se minimiza y se cierra con el formulario propietario. El método 
Show no devuelve nada. 





K 





Buscar registro 
Título 01 ES 
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Mostrar el diálogo equivale a establecer la propiedad Visible a true. A conti- 
nuación, defina la variable DlgBuscar como atributo privado de Form1: 


private DlgBuscarReg DlgBuscar; 


Por otra parte, la lista IsListaLibros de esta caja de diálogo tiene que visuali- 
zar los títulos de los libros, proceso que podemos realizar cuando se cargue el diá- 
logo. Esos datos serán obtenidos del objeto /istaLibros de la clase SortedList 
definido en Forml. Por lo tanto, añada al método DleBuscarReg Load el código 
indicado a continuación: 


private void DlgBuscarReg_Load(object sender, EventArgs e) 
( 
// Llenar la lista con los títulos de los libros 
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SortedList<string, Libro> objListaLibros = 
((Forml1)this.Owner).ObtenerDatos(); 
foreach (KeyValuePair<string, Libro> elemento in objlistaLibros) 
IsListaLibros.Items.Add(elemento.Key):; 


Observe que Owner nos da acceso a los miembros públicos de la clase 
Forml, como ObtenerDatos. De esta forma queda resuelto el acceso desde la ven- 
tana DleBuscarReg a la ventana Forml de la que depende, lo que permitirá asig- 
nar al control lista los títulos de los libros almacenados en el objeto SortedList. 


Una vez mostrada la lista de libros, el usuario seleccionará el libro que busca 
(clic en el nombre del libro), del cual quiere conocer el resto de los datos, y hará 
clic en el botón Aceptar (o simplemente pulsará la tecla Entrar) para que los datos 
relativos a dicho libro se visualicen en la ventana principal. Esto quiere decir que 
el método ligado con el botón Aceptar se encargará de obtener la clave (elemento 
seleccionado de la lista) y de visualizar en la ventana principal el elemento de lis- 
taLibros que tenga dicha clave. Para ello: 


e Añada a la clase Form] un método público que muestre en la ventana “Libros 
prestados” el elemento de /listaLibros que tenga la clave que se le pase como 
argumento: 


public void MostrarRegDatosí(string clave) 


Libro libro = listaLibros[clave]; 
ctTitulo.Text = libro.ObtenerTitulo(); 
ctAutor.Text = libro.ObtenerAutor(); 
ctEditorial.Text = libro.ObtenerEditorial(); 
ctPrestado.Text = libro.ObtenerPrestado(); 





e Añada a la clase DlgBuscarReg un método para controlar el evento Click del 
botón Aceptar que obtenga el elemento seleccionado de la lista (la clave) e 
invoque a MostrarRegDatos pasando este dato como argumento: 


private void btAceptar_Click(object sender, EventArgs e) 
( 
if (IsListalibros.Selectedindex < 0) return; 
((Forml)this.Owner).MostrarRegDatos( 
IsListalibros.Selectedltem.ToString()); 
) 


Una vez presentada la caja de diálogo Buscar registro, el usuario se puede 
encontrar con que el libro que busca no está en la lista y, debido a ello, simple- 
mente abandona esta caja de diálogo; para ello, hará clic en el botón Cancelar. 
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Quiere esto decir que el método ligado al botón Cancelar tiene que ocultar la caja 
de diálogo, operación que realiza el método Hide de la clase Form. Para añadir 
este método, proceda de igual forma que con el botón Aceptar. 


private void btCancelar_Click(object sender, EventArgs e) 
( 

Hide(); 
) 


Cuando un formulario se muestra como una caja de diálogo no modal y se ha- 
ce clic en el botón Cerrar (Œ), todos los recursos creados con el objeto se libe- 
ran y se elimina el formulario. El evento “cerrar” podría ser cancelado desde el 
controlador del evento FormClosing poniendo la propiedad Cancel del objeto 
CancelEventArgs que se pasa como argumento a true. 


En cambio, cuando se invoca al método Hide para ocultar el diálogo, este si- 
gue existiendo, no es destruido. Según esto, modifique el método ArchivoBuscar- 
Reg Click como se indica a continuación: 


private void ArchivoBuscarReg_Click(object sender, EventArgs e) 
( 
1f (DlgBuscar == null || DlgBuscar.IsDisposed) 
DlgBuscar = new DlgBuscarReg(); 
1/ 


Inicialmente, cuando se arranca la aplicación, DlgBuscar vale null. Cuando se 
crea un objeto DlgBuscarReg esta variable almacena la referencia a dicho objeto 
(el diálogo). Si se cierra el diálogo (clic en el botón Cerrar), el objeto DlgBuscar- 
Reg se destruirá (en este caso, la propiedad IsDispose valdrá true) pero la varia- 
ble DlgBuscar no se pondrá a null. Si se oculta el diálogo (clic en el botón 
Cancelar), el objeto DlgBuscarReg no se destruirá y podrá ser accedido; en este 
caso, cuando se vuelva a mostrar el diálogo no se producirá el evento Load, por- 
que ya está cargado, aunque oculto. 


También puede suceder que el usuario añada nuevos registros una vez presen- 
tada la caja de diálogo no modal Buscar registro. Esto implica actualizar la vista 
presentada por esta caja de diálogo. Para ello: 


e Añada a la clase DlgBuscarReg un método público Actualizar que inserte el 
nuevo libro en la posición de la colección de datos de IsListaLibros especifi- 
cada: 


public void Actualizar(int ind, Libro unLibro) 
( 
// Actualizar la lista con el nuevo título introducido 
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IsListalibros.Items.Insert(ind, unLibro.ToString()):; 
) 


e Modifique el método ArchivoAñadirReg Click de la clase Forml vinculado 
con la orden Añadir registro para que una vez añadido un nuevo registro, ac- 
tualice la lista del diálogo Buscar registro, si este existe, Iindependientemente 
de que pueda estar oculto: 


private void ArchivoAñadirReg_Click(object sender, EventArgs e) 
( 
// 


// Insertar el objeto Libro en orden ascendente según el título 
try 
( 

listaLibros.Add(ctTitulo.Text, unLibro); 

if (DlgBuscar != null 88 !DlgBuscar.IsDisposed) 

DlgBuscar.Actualizar( 
listaLibros.Index0fKey(ctTitulo.Text), unLibro); 

) 
catch (ArgumentException ex) 


( 





MessageBox.Show(ex.Message); // probablemente la clave ya existe 
) 
) 


Finalmente, cuando el usuario pulse el botón Borrar del diálogo Buscar regis- 
tro, el elemento seleccionado de la lista tiene que borrarse del objeto /istaLibros 
y, como consecuencia, debe actualizarse el control IsListaLibros. Para ello, añada 
a la clase DlgBuscarReg un método para controlar el evento Click del botón Bo- 
rrar y complételo como se indica a continuación: 


private void btBorrar_Click(object sender, EventArgs e) 
( 

int ind = IsListaLibros.Selectedindex; 

if (ind < 0) return; 


// Borrar en listalLibros el libro correspondiente al título seleccionado 
((Forml)this.Owner).ObtenerDatos().Remove( 
IsListaLibros.SelectedItem.ToString()); 
// Borrar el título seleccionado en el control lista 
IsListalibros.Items.RemoveAt(ind):; 





Para finalizar nuestra aplicación, queda por escribir el método asociado con la 
orden Salir del menú Archivo. Procediendo de forma análoga a como hizo con las 
otras órdenes de este menú, vincule el siguiente método con esta orden: 
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private void ArchivoSalir_Click(object sender, EventArgs e) 


{ 
Close(); 
} 


En algunos casos necesitará saber si un diálogo está visible u oculto; esto 
puede conocerlo a través de su propiedad Visible. Si el formulario está visible, es- 
ta propiedad vale true, y si está oculto vale false. 


EJERCICIOS PROPUESTOS 


1. Se propone completar el diseño del reloj despertador digital realizado en el apar- 
tado Ejercicios propuestos del capítulo anterior. El reloj tenía el aspecto mostrado 


en la figura siguiente: 





6 


82 Reloj despertador 


de 


Hora: 





Despertador: 


00:00:00 


Archivo Despertador 











Añadir À 


Eliminar 


A Londres 
20 x 1 ] Atenas 


Roma 
Nueva York 
Tokyo 


Hawai 











Allí pospusimos la inclusión de las órdenes Añadir país y Eliminar pais para 
cuando estudiáramos las cajas de diálogo, tema que ahora ya conocemos. 


Cuando el usuario ejecute la orden Añadir país, se visualizará una caja de diá- 


logo como la siguiente: 





Ta 





País: 


Diferencia horaria: 00:00:00 














Signo: 
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Esta caja permitirá al usuario introducir el nombre de un país y la diferencia 
horaria existente indicando si es negativa o positiva. Estos datos serán almacena- 
dos en una colección de objetos de tipo List y, además, el nombre del país dará 
lugar a un elemento nuevo en los menús País y contextual. 


Cuando el usuario ejecute la orden Eliminar país es porque desea quitar un 
país de los menús País y contextual. Esta operación requiere también actualizar la 
colección de objetos. Para ello, se visualizará la caja de diálogo Borrar país mos- 
trada a continuación, la cual permitirá seleccionar de una lista el nombre del país 
que desea eliminar. 





k 





Londres 
Atenas 
Roma 
Nueva York 

















Para que los datos persistan de una ejecución a otra, guarde en un fichero el 
par de datos país-diferencia horaria cuando se cierre la aplicación y recupérelos 
cuando se inicie. Estas operaciones resultarán sencillas si encapsula esos datos en 
objetos de una clase. Añada también al menú Archivo dos nuevas órdenes, Abrir y 
Guardar, que permitan cargar y guardar, respectivamente, un fichero con esos da- 
tos. 


Finalmente, la orden Ayuda visualizará otra caja de diálogo con una breve ex- 
plicación acerca de la aplicación. 


Para la realización del ejercicio se recomienda seguir los siguientes pasos: 


1. Diseñar un formulario Form2 con tres etiquetas, una caja de texto para el 
nombre del país, un control MaskedTextBox para la diferencia horaria, una 
casilla de verificación para el signo de la diferencia horaria (positivo sin mar- 
car, negativo marcada) y dos botones: Aceptar y Cancelar. 


2. Añadir una clase Pais cuyos objetos se puedan seriar, con los atributos 
m_Pais de tipo String, m_ DifHoraria de tipo long (la diferencia horaria la 
almacenaremos en ticks o pasos; 1 paso = 100 nanosegundos). 


3. Añadir a Forml un atributo privado que se corresponda con una colección 
List de elementos Pais denominada ListaPaises y otro DiferenciaHoraria de 
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10. 


11. 


tipo long que almacenará la diferencia horaria con respecto a nuestro país del 
país del cual se esté mostrando su hora local. 


Implementar un controlador vinculado con la orden Añadir para que visualice 
el diálogo Añadir país y añada los datos correspondientes a ListaPaises y a 
los menús País y contextual. 


Implementar un controlador vinculado con la orden Eliminar para que visua- 
lice el diálogo Borrar país y borre el país seleccionado de ListaPaises y de los 
menús País y contextual. 


Implementar el controlador vinculado con la orden correspondiente al país se- 
leccionado del menú País o del menú contextual, para que la etiqueta y la caja 
de texto correspondientes muestren el país y la hora en el mismo (Hora en). 


El reloj deberá presentar la hora actual en nuestro país en ctHora y la hora en 
otro país en ctHoraPais. Cuando no se haya seleccionado otro país ambas ca- 
jas mostrarán la misma hora. 


Si existe un fichero predeterminado que almacene países y sus diferencias ho- 
rarias, por ejemplo, “DifsHorsPredeterminado.bin”, cuando se inicie la apli- 
cación (evento Load) hay que añadir esos datos a los menús País y contextual 
y al objeto List. 


Cuando se cierre la aplicación (evento FormClosing) hay que guardar los da- 
tos almacenados en el objeto List en un fichero predeterminado (por ejemplo, 
en “DifsHorsPredeterminado.bin”). 


Añadir el menú Archivo con las órdenes Abrir y Guardar y escribir sus con- 
troladores. Estos deben permitir abrir o guardar cualquier otro fichero análogo 
a “DifsHorsPredeterminado.bin” (por ejemplo, “DifsHorsEuropa.bin”). 


Añada el controlador de la orden Acerca de..., del menú Ayuda para que 
muestre un diálogo con los créditos de la aplicación. 


CAPÍTULO 7 


O F.J.Ceballos/RA-MA 


TABLAS Y ÁRBOLES 


En los capítulos anteriores se han estudiado los componentes de uso más frecuen- 
te. Evidentemente, si echa una ojeada a la documentación proporcionada por 
MSDN, comprobará que hay muchos más componentes que puede incluir en sus 
aplicaciones, simplemente aplicando los conocimientos adquiridos, que de forma 
genérica resumimos así: crear el componente, establecer sus propiedades, añadirlo 
a un contenedor (si procede), añadir los controladores de eventos de aquellos que 
deseemos manipular y escribir el código que responda a tales eventos. En este ca- 
pítulo vamos a estudiar dos nuevos controles por la relevancia que tienen: tablas y 
árboles. Las tablas muestran los datos al usuario de una forma tabular y los árbo- 
les de una forma jerárquica. 


TABLAS 


Una tabla representa una de las formas más comunes de mostrar un conjunto de 
datos relacionados; por ejemplo, los registros de una base de datos. Este compo- 
nente, según muestra la figura siguiente, presenta la información distribuida en fi- 
las y columnas: 





6) Teléfonos 


Título 1 Título 2 Título 3 Título 4 
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Pues bien, la biblioteca de .NET incluye una clase denominada Data- 
GridView en el espacio de nombres System.Windows.Forms para permitir el 
acceso a un componente que puede manipular cualquier tipo de tabla. Este control 
proporciona una tabla para visualizar datos en la que se pueden personalizar las 
celdas, filas, columnas, bordes y color a través de sus propiedades. 


Así mismo, este control puede ser utilizado para mostrar datos independien- 
temente de que estos procedan o no de una fuente de datos. Cuando no se especi- 
fica una fuente de datos, se pueden crear columnas y filas y añadirlas al 
DataGridView. Cuando se especifica una fuente de datos, hay que hacerlo por 
medio de las propiedades DataSource y DataMember; en este caso, la tabla será 
rellenada automáticamente con los datos procedentes de esa fuente. Si la cantidad 
de datos manipulada es muy grande, se puede poner la propiedad VirtualMode a 
true para mostrar un subconjunto de esos datos. 


¿Cómo se añade una tabla a una ventana? Pues igual que añadimos cualquier 
otro control: construimos un objeto DataGridView, establecemos sus propieda- 
des, agregamos las columnas y lo añadimos al contenedor adecuado (normalmente 
a un formulario). Este control sustituye al control DataGrid de versiones anterio- 
res. Por ejemplo, la figura siguiente muestra una tabla en la que cada fila está 
formada por las columnas Fotografía, Nombre, Dirección, Teléfono y Casado: 





ls 
a Teléfonos erm 


Nombre Dirección Teléfono 


Alfons González Pérez Argentona, Barcelona 933333333 


Ana María Cuesta Suñer Gijón, Asturias 


Elena Veiguela Suárez Pontevedra 986678678 


Pedro Aguado Rodríguez Madrid 912804574 








Una tabla visualiza la información en celdas. Una celda, objeto de la clase 
DataGridViewCell, es la región formada por la intersección de una fila, objeto de 
la clase DataGridViewRow, y una columna, objeto de la clase DataGridView- 
Column. El usuario puede situarse en una fila cualquiera haciendo clic sobre ella 
o utilizando las teclas de movimiento del cursor, editar una celda seleccionándola 
y haciendo clic sobre ella (las celdas se pueden editar si la propiedad ReadOnly 
de la tabla vale false) o seleccionar una o más filas. 
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Cuando el número de filas y/o columnas es superior a la superficie de la tabla, 
es posible utilizar barras de desplazamiento por medio de la propiedad Scroll- 
Bars. La barra de desplazamiento horizontal solo aparecerá si la propiedad Auto- 
SizeColumnsMode no está puesta a Fill. 


Arquitectura de un control DataGridView 


Según lo expuesto, un control DataGridView contiene dos clases fundamentales 
de objetos: celdas y bandas o grupos de celdas (filas y columnas). La figura si- 
guiente muestra las clases que dan lugar a estos objetos: 


Object 


DataGridViewColumn 


Como muestra la figura anterior, el control DataGridView interacciona con 
varias clases, de las cuales, las más comúnmente empleadas son DataGridView- 
Column, DataGridViewRow y DataGridViewCell. 


El esquema de los datos almacenados en un DataGridView es expresado en 
columnas (objetos DataGridViewColumn), a las que podemos acceder a través 
de su colección Columns; y a las que estén seleccionadas, a través de su colec- 
ción SelectedColumns. 


De la clase DataGridViewColumn se derivan varios tipos de columnas: Da- 
taGridViewButtonColumn, DataGridViewCheckBoxColumn, DataGridView- 
ComboBoxColumnm, DataGridViewImageColumn, DataGridViewTextBoxCo- 
lumn y DataGridViewLinkColumn. 


Las filas (objetos DataGridViewRow) muestran los campos de los registros 
almacenados en un DataGridView. Podemos acceder a ellas a través de su colec- 
ción Rows; y a las que estén seleccionadas, a través de su colección Selected- 
Rows. 
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Cuando la propiedad AllowUserToAddRow de un DataGridView vale true, 
aparece al final de las filas la nueva fila que se puede añadir a la colección. 


La celda es la unidad fundamental de interacción con el control Data- 
GridView. Podemos acceder a cualquiera de ellas a través de la colección Cells 
de DataGridViewRow; y a las que estén seleccionadas, a través de la colección 
SelectedCells. 


DataGridViewCell es una clase abstracta de la cual se derivan los distintos 
tipos de celdas: DataGridViewButtonCell, DataGridViewCheckBoxCell, Data- 
GridViewComboBoxCell, DataGridViewHeaderCell, DataGridViewImageCell, 
DataGridViewLinkCell y DataGridViewTextBoxCell. 


Construir una tabla 


Como ejemplo, cree una nueva aplicación denominada TablaTfnos de forma que 
su ventana principal (objeto Form) muestre la tabla Teléfonos de la figura ante- 
rior. De forma predeterminada, la tabla mostrará barras de desplazamiento cuando 
sea necesario (SerollBars igual a Both). A continuación, añada al formulario los 
controles indicados a continuación con las propiedades especificadas: 


Ventana Name Forml 

principal Text Teléfonos 
Size 550, 310 
Name TablaTfnos 


AllowUserToOrderColumns True 
AutoSizeColumnsMode Fill 
AutoSizeRowsMode DisplayedCells 
ColumnHeadersHeightSizeMode | AutoSize 

Dock Fill 
RowHeadersWidthSizeMode AutoSizeToAllHeaders 





La propiedad AllowUserToOrderColumns permite cambiar el orden de las 
columnas. Para mover una columna, pulse la tecla Alt y arrástrela con el ratón a la 
posición deseada. AutoSizeColumnsMode indica cómo se determina la anchura 
de las columnas. AutoSizeRowsMode indica cómo se determina la altura de las 
filas. ColumnHeadersHeightSizeMode indica si la altura de la fila que contiene 
la cabecera de la columna es ajustable y si puede ser ajustada por el usuario o se 
ajusta automáticamente. Dock indica a qué lados del contenedor se ajustará la ta- 
bla. RowHeadersWidthSizeMode indica si la anchura de la columna que contie- 
ne la cabecera de la fila es ajustable y si puede ser ajustada por el usuario o se 
ajusta automáticamente. 
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Una vez finalizado el diseño anterior, el asistente para diseño de formularios 
habrá añadido una nueva clase cuyo código resumimos a continuación (la totali- 
dad del código se localiza en la carpeta Cap07|TablaTfnos del CD): 


partial class Forml 
{ 
LIE as 
private DataGridView TablaTfnos; 





ablaTfnos = new DataGridView(); 


// Establecer las propiedades 
TablaTfnos.Name = "TablaTfnos"; 
ablaTfnos.AllowUserTo0rderColumnms = true; 
I awk 
Controls.Add(TablaTfnos); 
1! 














Observe el código anterior y fíjese en cómo se implementa una tabla. Básica- 
mente, basta con crear un objeto DataGridView y añadirlo al formulario. 


Añadir las columnas a la tabla 


Esta operación la podemos realizar a través de la lista de tareas programadas del 
control DataGridView: 























Elegir origen de datos: 
Editar anp 
Agregar colurána... 


Y] Habilitar acción de agregar 
































Y] Habilitar edición 








Y] Habilitar eliminación 














Y] Habilitar reordenación de columnas 





Desacoplar en contenedor primario 


] 


Añadir una columna supone crear un objeto DataGridView TextBoxColumn 
(o de otro tipo), establecer sus propiedades y añadirla a la tabla. El código que se 
muestra a continuación añade la columna colNombre a la tabla TablaTfnos: 











private DataGridViewlextBoxColumn colNombre; 


colNombre = new DataGridViewTextBoxColumn(); 
// Establecer las propiedades 
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colNombre.Name = "colNombre"; 


colNombre.HeaderText = "Nombre"; 
LL us 
TablaTfnos.Columns.Add(colNombre); 
// 


Para nuestro ejemplo, a través de la opción Editar columnas... de la lista de 
tareas, añadiremos una primera columna de tipo DataGridViewImageColumn, 
tres columnas más de tipo DataGridViewTextBoxColumn y una última de tipo 
DataGridViewCheckBoxColumn, según muestra la figura anterior. Por ejemplo, 
la figura siguiente muestra la columna colFoto y sus propiedades (en este caso no 
hemos puesto un título de cabecera; sí lo hemos hecho para el resto de las colum- 
nas: colNombre, colDireccion, colTelefono y colCasado). 






































1 = y 
Editar columnas bes 

Columnas seleccionadas: Propiedades de columna sin enlazar 

E) + z| 

| E Nombre | Am 4 Datos a 

x "m + 

| Æ Dirección | DataPropertyName (ninguno) 

| | 

| E Teléfono 4 Diseño 

[El Casado colFoto] 
AutoSizeMode NotSet 
ColumnType DataGridViewImageColumn 
DividerWidth 0 [ 
FillWeight 40 | 
Frozen False Z 
MinimumWidth 5 | 
Width 61 | 

(Name) 
Agregar.. | | a Indica el nombre utilizado en el código para identificar e... 
Aceptar ) | Cancelar 
K d 








Iniciar la tabla 


Según hemos visto, los elementos de una tabla pueden ser de diferentes tipos; por 
lo tanto, su iniciación dependerá del tipo elegido. Por ejemplo, en el código si- 
guiente se puede observar que cada fila de datos se ha generado a partir de una 
matriz de tipo object con tantos elementos como campos tiene cada fila y des- 
pués, se han añadido a la colección Rows de la tabla: 


private void AsignarDatosTabla() 


{ 
// Crear cada fila de datos 
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object[1 fila0 = { "../../Imagenes/foto.jpg", 
"Alfons González Pérez", 
"Argentona, Barcelona", "933333333", true }; 


object[1 filal = [ "../../Imagenes/foto.jpg”, 

"Ana María Cuesta Suñer", 

"Gijón, Asturias", "984454545", false }; 
object[1 fila2 = { "../../Imagenes/foto.jpg", 


"Elena Veiguela Suárez", 
"Pontevedra", "9866/8678", false }; 
object[1 fila3 = [ "../../Imagenes/foto.jpg”, 

"Pedro Aguado Rodríguez", 

"Madrid", "912804574", true }; 

// Añadir las filas a la tabla 
ablaTfnos.Rows.Add(fila0); 

ablaTfnos.Rows.Add(filal); 

ablaTfnos.Rows.Add(fila2); 

ablaTfnos.Rows.Add(fila3); 













































































Obsérvese que el primer dato de cada fila se corresponde con la ruta de la fo- 
tografía a mostrar y no con la imagen en sí. 


De forma predeterminada, un DataGridView intentará convertir el valor de 
una celda en un formato apropiado para la presentación. Si fuera preciso, la pro- 
piedad de DefaultCellStyle del DataGridView permite a través de la propiedad 
Format de DataGridViewCellStyle establecer la convención de formato. Si este 
formato estándar es insuficiente se puede personalizar controlando el evento Cell- 
Formatting. 


El evento CellFormatting se genera cada vez que una celda tiene que ser pin- 
tada y permite indicar el valor exacto a mostrar junto con los estilos de la celda, 
como el color de fondo y del primer plano. El valor de la celda está referenciado 
por la propiedad Value del parámetro de tipo ConvertEventArgs del controlador 
de este evento. 


Según lo expuesto, vamos a añadir el controlador del evento CellFormatting 
para convertir el valor de la ruta de la fotografía en la imagen a mostrar en la co- 
lumna colFoto para, a continuación, asignársela a la celda que se está pintando: 


public partial class Forml : Form 
( 
public Forml1() 
( 
InitializeComponent():; 
AsignarDatosTabla(); 
) 
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private void AsignarDatosTabla() 
( 

1! 
) 


private void TablaTfnos_CellFormatting(object sender, 


DataGridViewCellFormattingEventArgs e) 
( 
switch (this.TablaTfnos.Columms[e.ColumnIndex].Name) 
( 
case "colFoto": 
if (e.Value != null) // e.Value : valor de la celda 
try 
( 
e.Value = Image.FromFile(e.Value.ToString()); 
) 
catch (System.I0.FileNotFoundException exc) 
( 
e.Value = null; 
) 
break; 


Ejecute ahora la aplicación. Como cabía esperar, durante la ejecución pode- 


mos escribir directamente en cada celda, añadir y borrar filas. Esto es, una tabla 
que utilice el modelo predeterminado: 


1. 


Tiene todas sus celdas editables; esto se traduce en que la propiedad ReadOn- 
ly de la tabla vale false. Esta propiedad puede establecerse también a nivel de 
celda, fila o columna. 


Cuando las columnas son de tipo DataGridViewTextBoxColumn los datos 
son tratados como cadenas de caracteres, pero esto no tiene por qué ser siem- 
pre así; por ejemplo, la columna declarada de tipo DataGridViewCheck- 
BoxColumn muestra en cada celda una casilla de verificación a la que le 
corresponden los valores true o false, o la columna declarada de tipo Data- 
GridViewImageColumn, que muestra en cada celda una imagen. 


Requiere que los datos sean colocados en una matriz, cuando en ocasiones 
puede ser interesante obtener los datos directamente desde una fuente externa 
como una base de datos. En este caso, la solución es utilizar, como fuente de 
datos, alguno de los objetos que estudiaremos más adelante en el capítulo titu- 
lado Enlace de datos en Windows Forms. 
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Como ejemplo de lo expuesto, vamos a modificar la aplicación para que ahora 
tome los datos de una supuesta base de datos modelada por medio de las clases 
siguientes: 














bbdd A Persona A BindingListPersonas XA 
Clase Clase Clase 
+ BindingList<Persona> 
= Métodos = Propiedades 
®© ObtenerDatos # casado 
= # direccion 
# foto 
# nombre 
# telefono 
= Métodos 


®© Persona (+ 1 sobre... 





Un DataGridView admite como origen de datos cualquier tipo que imple- 
mente una de las siguientes interfaces: 


TList, como sucede con List<7> y las matrices unidimensionales. 
IListSource, como sucede con DataTable y DataSet. 
IBindingList, como sucede con BindingList<7>. 
IBindingListView, como sucede con BindingSource. 


IBindingList aporta un mecanismo de enlace de datos bidireccional, lo que 
nos permitirá de forma automática añadir nuevos registros, mientras que IList no. 


Pues bien, nuestro origen de datos será establecido mediante la propiedad Da- 
taSource del DataGridView. También podría ser establecido a través de un obje- 
to BindingSource; es recomendable utilizar este objeto por la funcionalidad que 
aporta, aunque dejaremos esto para estudiarlo en el capítulo Enlace de datos en 
Windows Forms. 


En función de lo expuesto, el origen de datos va a ser una colección Binding- 
List<7> de objetos de la clase Persona. Cada objeto persona tiene un conjunto de 
propiedades que hacen referencia a los datos que mostrarán las columnas de la ta- 
bla. Esta colección será devuelta por el método static ObtenerDatos de la clase 
bbdd que representa la base de datos. Las tres clases a las que hemos hecho refe- 
rencia serán incluidas en una carpeta BBDD del proyecto. 


Partiendo del modelo de datos diseñado, añada a la clase un atributo privado 
listFilas de tipo BindingListPersonas que proporcione a la aplicación la colección 
de objetos Persona extraídos de la base de datos que va a ser mostrada en el Da- 
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taGrid View. Después, en el constructor de la clase Form1, obtenga esa colección 
y asígnesela a la propiedad DataSource del DataGridView. 


Otra operación que tenemos que hacer es asignar a la propiedad AutoGenera- 
teColumns el valor false, la cual indica si las columnas se crean automáticamente 
cuando se establece la propiedad DataSource. En nuestro caso, las columnas ya 
están creadas, por lo que no queremos que se vuelvan a crear otra vez a partir del 
esquema del origen de datos: 


TablaTfnos.AutoGenerateColumns = false; 


También tendremos que modificar el controlador del evento CellFormatting 
ya que a diferencia de la versión anterior, ahora se asignan los valores almacena- 
dos en las propiedades de los objetos Persona de la colección. Ahora, ¿qué pro- 
piedad del objeto Persona en curso se asigna a cada columna de la fila? Eso lo 
podemos especificar fácilmente a través de la opción Editar columnas... de la lista 
de tareas asignando a la propiedad DataPropertyName de cada columna de la ta- 
bla el nombre de la propiedad correspondiente del objeto Persona: 





r 












































Mm 
Editar columnas 12 e 
Columnas seleccionadas: Propiedades de columnas enlazadas 
al ||. Ja | 
[El Nombre | ToolTipText E 
E Dirección | Le] Visible True 
| E Teléfono 4 Comportamiento 
{z Casado ContextMenuStrip (ninguno) f 
ReadOnly False | 
Resizable True | = 
SortMode NotSortable | 
4 Datos 
foto z 
4 Diseño Lo 
(Name) colFoto 
AutoSizeMade NotSet > 
DataPropertyName 
Agregar.. | | RE El nombre de la propiedad de origen de datos o la colu... 
Aceptar |] | Cancelar 
K d 














Según lo expuesto, el código quedará así: 


public partial class Forml : Form 
( 
private BindingListPersonas listFilas = null; 
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public Forml() 

{ 
InitializeComponent(); 
TablaTfnos.AutoGenerateColumns = false; 
listFilas = bbdd.ObtenerDatos(); 
TablaTfnos.DataSource = listFilas; 





) 


private void TablalTfnos_CellFormatting(object sender, 

DataGridViewCellFormattingEventArgs e) 

{ 
// Si fila nueva, volver para introducir los datos en la tabla. 
if (e.RowIndex > listFilas.Count - 1) return; 

// Construir la tabla con los datos de la colección. 
switch (this.TablaTfnos.Columns[le.ColumnIndex].Name) 
{ 
case "colFoto": 
if (e.Value != null) 
try 
{ 
e.Value = Image.FromFile(listFilas[e.RowIndex].foto); 
} 
catch (System.10.FileNotFoundException exc) 
{ 
e.Value = null; 
} 
break; 





Ahora, en cuanto ejecute la aplicación y haga clic en una nueva fila e intro- 
duzca los datos, esa fila pasará a formar parte también de la colección. 


A — 


Ana María Cuesta Suñer 




















Bena Veiguela Suárez 





Pedro Aguado Rodriguez 912804574 























¿Telefono? 
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Si desea verificar los datos que tiene la colección /istFilas en un instante de- 
terminado, puede hacerlo escribiendo un código como el siguiente: 


private void listaloolStripMenultem_Click(object sender, EventArgs e) 
( 
ListPersona lista = Tablalfnos.DataSource as ListPersona; 
foreach (Persona p in lista) 
Console.WritelLine("(0) {1} (2) (3)", 
p.nombre, p.direccion, p.telefono, p.casado); 


Tamaño de las celdas 


Observe que inicialmente todas las columnas tienen la misma anchura. Así mis- 
mo, cuando el usuario redimensiona una columna, alguna de las otras columnas 
debe ajustar su tamaño para que el tamaño de la tabla permanezca igual, y cuando 
el usuario modifica el tamaño de la ventana, todas las columnas de la tabla se re- 
dimensionan (recuerde que hemos establecido la propiedad Dock a Fill). 


Cada columna de la tabla está representada por un objeto DataGridViewCo- 
lumn. Las propiedades Width y MinimumWidth almacenan, respectivamente, la 
anchura actual y la mínima de una columna, valores a los que podremos acceder 
durante el diseño o durante la ejecución. Por otra parte, si la propiedad AutoSi- 
zeMode de la columna vale Fill (o la propiedad AutoSizeColumnsMode de la 
tabla, que en nuestro caso vale Fill), el ancho se tomará de la propiedad Fill- 
Weight. Como ejemplo, vamos a fijar el ancho de las columnas de la tabla Telé- 
fonos como muestra la figura siguiente, asignando a la propiedad FillWeight de 
cada columna los valores 40, 96, 96, 54 y 30, respectivamente: 





r 
ul Teléfonos 


Nombre Dirección Teléfono Casado 


Alfons González Pérez Argentona, Barcelona 933333333 T 


Ana María Cuesta Suñer Gijón, Asturias 


Blena Veiguela Suárez Pontevedra 986678678 


Pedro Aguado Rodriguez Madrid 912804574 








Además, la propiedad AutoSizeRowsMode permite especificar la conducta 
seguida para dar tamaño automático a las filas visibles, RowHeadersWidth espe- 
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cifica el ancho de las cabeceras de las filas y RowHeadersWidthSizeMode la 
conducta seguida para ajustar el ancho de las cabeceras de las filas. Análogamen- 
te, la propiedad ColumnHeadersHeight especifica la altura de las cabeceras de 
las columnas y ColumnHeadersHeightSizeMode la conducta seguida para ajus- 
tar la altura de las cabeceras de las columnas. 


Acceder al valor de la celda seleccionada 


Para obtener el valor de la celda correspondiente a la fila f y columna c de un Da- 
taGridView hay que hacerlo a través de su colección Rows. Por ejemplo: 


object valorCelda = TablaTfnos.Rows[f].Cells[c].Value; 


La expresión Rows[f] hace referencia a la fila f. Una fila es una colección de 
celdas identificada por la propiedad Cells de la misma. La expresión Cells/[c] hace 
referencia a la celda c (columna c) dentro de esta fila. Finalmente, para acceder al 
valor de esta celda utilizaremos su propiedad Value. 


Cuando queremos que esa celda se corresponda con la seleccionada en cada 
momento, podemos obtener el valor de f y el de c a través de CurrentCellAd- 
dress. Por ejemplo: 





int f = Tablalfnos.CurrentCellAddress.Y; 
int c = Tablalfnos.CurrentCellAddress.X; 
object valorCelda = TablaTfnos.Rows[f].Cells[c].Value; 











También podemos utilizar la propiedad CurrentCell, lo que resulta más sen- 
cillo. Por ejemplo: 


object valorClelda = TablaTfnos.CurrentCell.Value; 


Otras propiedades de interés son CurrentRow, fila actualmente seleccionada, 
y FirstDisplayedCell, primera celda visible (la de la esquina superior izquierda 
del área de visualización). 


Como ejemplo, vamos a modificar la aplicación anterior para que permita ob- 
tener el valor de la celda que el usuario seleccione con el ratón. Para ello, hay que 
añadir a la clase Form1 un controlador de eventos CellClick que permita capturar 
cada clic que el usuario haga sobre una celda. La respuesta a este evento será la 
ejecución de un método similar al siguiente: 


private void Tablalfnos_CellClick(object sender, 
DataGridViewCellEventArgs e) 
( 
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// Cuerpo del método 


1 
J 


El parámetro sender hace referencia al DataGridView y el parámetro e tiene 
dos propiedades, RowIndex y ColumnIndex, que almacenan la fila y la columna 
de la celda sobre la que el usuario hizo clic. 


Según lo expuesto, para mostrar el valor de la celda que el usuario seleccione 
con el ratón, puede añadir al método anterior el código siguiente: 


object valorCelda = 
TablaTfnos.Rows[e.RowIndex].Cells[e.ColumnIndex].Value; 
if (valorCelda != null) MessageBox.Show(valorCelda.ToString()); 


O bien, 


object valorCelda = TablaTfnos.CurrentCell.Value; 
if (valorCelda != null) MessageBox.Show(valorCelda.ToString()); 


El código anterior obtiene el valor de la celda seleccionada solo si se pulsó el 
botón izquierdo del ratón. 


Si quisiéramos obtener el valor de todas las celdas, necesitaríamos conocer el 
número de filas y de columnas de la tabla. Estos valores son devueltos por las 
propiedades RowCount y ColumnCount. Los métodos DisplayedRowCount y 
DisplayedColumnCount devuelven, respectivamente, el número de filas y de co- 
lumnas actualmente visualizadas. 


ÁRBOLES 


El componente TreeView visualiza una lista jerárquica de elementos, denomina- 
dos normalmente “nodos”, compuestos cada uno de ellos por una etiqueta y un 
icono procedente de un fichero de imagen (por ejemplo, de un fichero .png). Un 
objeto TreeView no contiene en realidad los datos; simplemente proporciona una 
vista de los mismos. Pero, igual que sucede con otros controles, define una co- 
lección para gestionar los datos que representa. Un ejemplo del componente 
TreeView es el árbol de directorios visualizado en el panel izquierdo del adminis- 
trador de archivos, del cual la figura siguiente muestra una vista parcial: 


4h vc* 

4 |. CSharpProjectltems 
J Windows Forms 
J CSharpProjects 
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Como se puede observar en la figura anterior, un TreeView muestra sus ele- 
mentos verticalmente. Cada fila contiene exactamente un elemento de datos, esto 
es, un nodo. Cada árbol tiene un nodo raíz del que descienden todos los nodos. Un 
nodo puede tener nodos descendientes o no, a los que nos referimos como nodos 
hijo. Un nodo que tiene nodos hijo se denomina nodo de bifurcación y cuando no 
tiene hijos recibe el nombre de nodo hoja. En la figura anterior, VC# es el nodo 
raíz de ese árbol, CSharpProjectltems es un nodo de bifurcación que es padre del 
nodo hijo Windows Forms y este último es un nodo hoja. 


Un nodo de bifurcación o nodo padre puede tener cualquier número de hijos. 
Generalmente, el usuario puede expandir un nodo padre para que muestre sus hi- 
jos, o recogerlo para que no los muestre, haciendo clic sobre él. 


Arquitectura de un árbol 


Las propiedades clave de un control TreeView son Nodes y SelectedNode. La 
primera contiene una lista de los nodos de nivel superior (el nivel de la raíz es el 
0) y la segunda contiene el nodo actualmente seleccionado. 


A continuación del nodo pueden ser visualizadas una imagen y una etiqueta; 
la lista de imágenes será referenciada por la propiedad Imagelist del árbol, y el 
texto de la etiqueta, por la propiedad Text. Esta etiqueta podrá ser modificada por 
el usuario si la propiedad LabelEdit del árbol vale true. 


Nodes representa una colección de tipo TreeNodeCollection de objetos 
TreeNode, cada uno de los cuales tiene, a su vez, su propia colección Nodes para 
almacenar sus nodos hijo. Este anidamiento de nodos en el árbol podría dificultar 
la navegación por el mismo, a no ser por la propiedad FullPath, que nos dice en 
todo momento nuestra posición en el árbol. Así mismo, el método Find de la co- 
lección permite buscar un nodo por su clave que coincide con la propiedad Name. 


Construir un árbol 


Como ya hemos indicado, un árbol es un objeto TreeView cuyos nodos serán 
proporcionados por la clase TreeNode independientemente de que se trate del no- 
do raíz, de bifurcación u hoja. Si un nodo no tiene ascendientes, se trata del nodo 
raíz; si tiene hijos, es un nodo de bifurcación, y si no los tiene, es un nodo hoja. 
Como ejemplo, vamos a crear el árbol que muestra la figura siguiente. Para ello, 
cree el esqueleto para una nueva aplicación que utilice un formulario de la clase 
Form como ventana principal. Denomínela ArbolTfnos. Desde la barra de herra- 
mientas, añada al formulario un control TreeView y después, a través de la lista 
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de tareas programadas de este control, construya el árbol de la figura siguiente. 
Esta aplicación se encuentra en la carpeta Cap07lArbolTfnos del CD. 


r 
WF Árbol teléfonos -|o ade) 
ENE] toros 


B- Amigos 
64D A 
© teléfono 14 
(2) teléfono 2A 





8-45) Clientes 
B DB B 
(5) teléfono 1B 








Una vez haya añadido el control TreeView al formulario, tendrá un árbol sin 
nodos. Eche una ojeada a la clase Form] mostrada a continuación: 


partial class Forml 
( 

LN E 
private TreeView ArbolTfnos; 





ArbolTfnos = new TreeView():; 


// Establecer las propiedades 
ArbolTfnos.Name "ArbolTfnos"; 
ArbolTfnos.Dock DockStyle.Fill; 
/1 





Controls.Add(ArbolTfnos); 
1] 


En el código anterior se puede observar lo sencillo que resulta implementar 
un árbol. Básicamente, basta con crear un objeto TreeView e incluirlo en el for- 
mulario. Posteriormente añadiremos sus nodos. 


Añadir nodos a un árbol 


Para añadir nodos padre e hijos, puede hacerlo desde la lista de tareas programa- 
das del control TreeView, desde la ventana de propiedades a través de la propie- 
dad Nodes, o bien escribiendo el código adecuado en un método que podemos 
invocar desde el controlador del evento Load del formulario. En cualquiera de los 
dos casos el código resultante será análogo al siguiente: 


TreeNode NodoRaiz = new TreeNode():; 
NodoRaiz.Name = "NodoRaiz":; 
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NodoRaiz.Text = "Teléfonos"; 


ArbolTfnos.Nodes.AddRange(new TreeNode[] ([NodoRaiz)); 


El código anterior crea NodoRaiz de la clase TreeNode invocando a su cons- 
tructor sin argumentos, establece sus propiedades y lo añade a la colección Nodes 
del árbol. Como se trata de añadir un solo nodo, podríamos escribir también: 


ArbolTfnos.Nodes.Add(NodoRaiz); 


Añadamos ahora un nodo hijo al nodo anterior. El código anterior se modifica 
de la forma siguiente. Construimos el nodo hijo, NodoAmigos, pasando como ar- 
gumento al constructor el texto que mostrará; después, construimos el nodo padre, 
pasando en este caso al constructor TreeNode como primer argumento el texto 
que mostrará y como segundo una matriz con los nodos hijo, en nuestro caso uno, 
NodoAmigos. Finalmente, establecemos sus propiedades y añadimos el nodo raíz 
al árbol. 


TreeNode NodoAmigos = new TreeNode("Amigos"”); 
TreeNode NodoRaiz = 
new TreeNode("Teléfonos", new TreeNode[] { NodoAmigos )); 
NodoAmigos.Name = "NodoAmigos”; 
NodoRaiz.Name = "NodoRaiz"; 
ArbolTfnos.Nodes.AddRange(new TreeNode[] { NodoRaiz }); 





Imágenes para los nodos del árbol 


Un nodo, además del texto, puede visualizar una imagen. Las imágenes que utili- 
cemos serán tomadas de un control ImageList referenciado por la propiedad 
ImageList del control TreeView. 


Normalmente, los controles, como ListView, TreeView o ToolBar, utilizan 
un objeto ImageList para almacenar las imágenes que necesiten. Estas imágenes 
pueden ser mapas de bits, iconos o metarchivos. Un objeto ImageList, igual que 
sucede con otros controles, define una colección para gestionar las imágenes que 
almacena. Esta colección de la clase ImageCollection está representada por su 
propiedad Images. 


En el caso de un TreeView, normalmente, cada nodo tiene asociadas dos 
imágenes: la que mostrará cuando no esté seleccionado y la que mostrará cuando 
sí lo esté. El índice de la primera lo guardaremos en su propiedad Imagelndex, y 
el de la segunda, en SelectedImagelndex. 
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Para esta aplicación, vamos a crear dos imágenes de 16x16: CarpetaCerra- 
da.png y CarpetaAbierta.png. Las guardaremos en una subcarpeta Imagenes de la 
carpeta de la aplicación. 


A continuación, desde la barra de herramientas añadiremos a la aplicación un 
control ImageList que denominaremos ImagsNodos. Para añadir las imágenes a 
este control Imagelist, selecciónelo, diríjase a la ventana de propiedades y edite 
su propiedad Images; desde la ventana que se visualiza añada las imágenes ante- 
riormente creadas. Finalmente, asigne a la propiedad ImageList del control 
TreeView la lista de imágenes (/magsNodos). Estas operaciones darán lugar a que 
se genere el código siguiente: 


private Imagelist ImagsNodos; 

ImagsNodos = new ImageList():; 

ImagsNodos.ImageStream = 
(ImageListStreamer)resources.Get0bject("ImagsNodos.ImageStream"); 

ArbolTfnos.ImageList = this.ImagsNodos; 


La propiedad ImageStream identifica el objeto ImageListStreamer asocia- 
do a esta lista de imágenes. En nuestra aplicación, este objeto ha sido definido en 
el fichero Forml.resx con el nombre ImagsNodos.ImageStream y contiene las 
imágenes en binario. 


Por último, estableceremos las propiedades Imagelndex y Selectedlmage- 
Index de cada nodo. Asigne a la primera el índice O (primera imagen de la lista) y 
a la segunda el índice 1 (segunda imagen de la lista). Por ejemplo: 


NodoRaiz.Imagelndex = 0; 
NodoRaiz.SelectedImagelndex = 1; 


Esta operación la puede realizar desde el diseñador en el instante en el que 
añade cada nodo o escribiendo un código análogo al anterior. 


Iniciar el árbol 


En los apartados anteriores hemos visto cómo construir un árbol con unos nodos 
especificos. Pero, en ocasiones, requeriremos añadir nodos o construir totalmente 
el árbol dinámicamente. Esto puede hacerse escribiendo un método que imple- 
mente el código adecuado a la operación que deseamos realizar. Por ejemplo, su- 
pongamos que deseamos construir el árbol anterior, pero durante la ejecución; 
concretamente, al iniciar la aplicación. Para ello, podemos escribir un método 
crearNodos y después invocarlo cuando se cargue el formulario. Según lo estu- 
diado hasta ahora, este método podría ser así (esta aplicación se encuentra en la 
carpeta Cap07ArbolTfnos-v2 del CD): 
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private void CrearNodos() 
{ 
// Nodo Amig 
TreeNode Nod 


os e hijos 
oTfnolA = new TreeNode("teléfono 1A"); 
od olA.Name = "NodoTfnolA"; 

olA.ImageIndex 0; 
olA.SelectedImageIndex 1; 

e Nodolfno2A = new TreeNode("teléfono 2A"); 
o2A.Name = "NodoTfno2A"; 

02A.Imagelndex 0; 
o2A.SelectedImagelndex 
e NodoA = 
TreeNode("A", new 
ame "Nodoa"; 
odoA.ImageIndex 0; 
odoA.SelectedImagelndex 
TreeNode NodoAmigos 
ew TreeNode("Amigos", new TreeNodel] 
oAmigos.Name = "NodoAmigos”; 
oAmigos.Imagelndex 0; 
oAmigos.Selectedlmagelndex 








1 








TreeNode[] { NodoTfnolA, NodoTfno2A )); 


oq 


l; 





{ NodoA }); 





oq 
oq 
oq 














l; 


// Nodo Clie 
TreeNode Nodo 


tes e hijos 

TfnolB = new TreeNode("teléfono 1B"); 
odoTf B.Name "NodoTfnol1B"; 

odoTf B.Imagelndex 0; 
odoTf B.SelectedImageIndex 
TreeNode NodoB = 

ew TreeNode("B", 
oB. e "NodoB"; 
odoB.Imagelndex = 0; 
odoB.SelectedImagel 
TreeNode NodoClientes 
ew TreeNode("Clie 
oClientes.Name 
oClientes.Imagelnd 
oClientes.Selected 








1% 


ew TreeNode[] { NodoTfno1B )); 


oq 


39895350000 





dex ds 


tes", new TreeNodel[] 
NodoClientes”; 

ex 0; 
Imagelndex 








[ NodoB }); 


oq 
oq 
oq 




















li; 
// Nodo raíz del 
TreeNode NodoRaiz 
new TreeNode("Teléfonos", 
new TreeNode[] 
"NodoRaiz"; 


árbol 





{ NodoAmigos, NodoClientes }); 





NodoRaiz.Name = 


NodoRaiz.Text 
NodoRaiz.Imag 
NodoRaiz.Sele 


"Teléfon 
elndex 0; 
ctedImageln 


OS 


dex = 1; 


// Añadir la raíz a Arbollfnos 


this.ArbolTfn 





os.Nodes.Ad 


dRange(new TreeNode[] { NodoRaiz )); 
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Así mismo, en lugar de utilizar el diseñador para añadir las imágenes a la lista 
de imágenes, podríamos escribir un método que lo hiciera y que invocaríamos 
como respuesta al evento Load del formulario. Este método, para la aplicación 
que nos ocupa, podría ser así: 


public void Cargarlmagenes() 

( 
System.Drawing.Image milmagen; 
milmagen = Image.FromFile("..\\..\\Imagenes\\CarpetaCerrada.png"); 
ImagsNodos.Images.Add(milmagen); 
milmagen = Image.FromFile("..\\..\\Imagenes\\CarpetaAbierta.png"); 
ImagsNodos.Images.Add(miImagen); 


El método compartido FromFile de la clase Image del espacio de nombres 
System.Drawing crea un objeto Image a partir del fichero especificado. 


Finalmente, añadimos el controlador del evento Load del formulario: 


private void Forml_Load (Object sender, EventArgs e) 
( 

CargarImagenes():; 

CrearNodos(); 
) 


Acceder al nodo seleccionado 


Vamos a estudiar ahora cómo se accede a los datos de un nodo. Como ejemplo, 
vamos a hacer un poco más real nuestra aplicación ArbolTfnos. Esta aplicación, 
que se encuentra en la carpeta Cap07lArbolTfnos-v3 del CD, mostrará un listín de 
teléfonos clasificado por categorías (“Amigos”, “Clientes”, “Proveedores”, etc.) y 
dentro de cada categoría los nodos estarán agrupados alfabéticamente según la 
inicial del nombre (“A”, “B”, “C”, etc.). 


z 
al Árbol teléfonos Lal A) 
0 


2-5) Amigos 
EY 
D Alfons 





D Ana 
040 B 
(5) Beatriz 
2-3) Clientes 








Como se puede observar en la figura, cada nodo hoja del árbol visualiza el 
nombre de la persona cuyo teléfono, así como otros datos de interés, deseamos 
mostrar cuando ese nodo sea seleccionado; por ejemplo, así: 
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Datos =z 


O: 
LY Pontevedra 


986666666 
casado/a 





Aceptar 














Evidentemente, cada nodo hoja debe, en este caso, hacer referencia a un obje- 
to que encapsule los datos mostrados en la ventana anterior. Para ello, vamos a 
añadir a nuestra aplicación una clase C7fno derivada de TreeNode como la si- 
guiente: 


public class Tfno : TreeNode 
( 
internal string nombre; // internal para permitir el acceso desde 
// cualquier parte de la aplicación 
private string dirección; 
private long teléfono; 
private bool casado; 


// Constructor: crea un nuevo objeto Tfno con los parámetros: 
// nombre, dirección, teléfono, casado 
public Tfno(string nom, string dir, long tfno, bool cas) 
( 
nombre = nom; 
dirección = dir; 
teléfono = tfno; 
casado = cas; 
) 


// Constructor: crea un nuevo objeto Tfno con los parámetros: 
// nombre, dirección, teléfono, casado, etiqueta, índice imagen 
// nodo no seleccionado, índice imagen nodo seleccionado 
public Tfno(string nom, string dir, long tfno, bool cas, 
string etiq, int img0, int imgl) : base(etiq, img0, imgl) 
( 

nombre = nom; 

dirección = dir; 

teléfono = tfno; 

casado = Cas; 
) 


public override string ToString() 
( 
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return nombre; 


) 


public string datosTfno() 

( 
string NL = Environment.NewLine; 
string estado; 
if (casado) 


( 


estado = "casado/a":; 
) 
else 
( 

estado = "soltero/a"; 


) 
return nombre + NL + dirección + NL + teléfono + NL + estado + NL; 


El método ToString de la clase Tfno permite representar un objeto de la mis- 
ma por su atributo nombre, y el método datosTfno devuelve un string con todos 
los valores de todos los atributos separados por un retorno de carro. 


Ahora, durante el proceso de construcción del árbol, cada vez que se constru- 
ya un nodo hoja habrá que construir un objeto de la clase Tfno y asignárselo al 
nodo padre correspondiente. Por ejemplo, supongamos que durante el diseño de la 
aplicación anterior hemos construido un árbol con un solo nodo: el nodo raíz. El 
resto de los nodos, según muestra la figura anterior, los vamos a añadir cuando 
ejecutemos la aplicación, en el instante en el que se carga el formulario: 


private void Forml_Load(object sender, EventArgs e) 
( 
CrearNodos(); 


} 


private void CrearNodos() 
{ 
TreeNode nodoRaiz = ArbolTfnos.Nodes[0]; 

TreeNode nodoCategoria = null; // nodo de bifurcación 
TreeNode nodoLetra = null; // nodo de bifurcación 
Tfno nodoTelefono = null; // nodo hoja 
nodoCategoria = new TreeNode("Amigos", 0, 1); 
nodoRaiz.Nodes.Add(nodoCategoria); 








nodoLetra = new TreeNode("A", 0, 1); 

nodoTelefono = new Tfno("Alfons", "Barcelona", 933333333, 
CPUs “Alroms". 0, 1)? 
nodoLetra.Nodes.Add(nodoTelefono); 

nodoTelefono = new Tfno("Ana", "Pontevedra", 986666666, 
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cre, “mar. Os, 1)s 
odoLetra.Nodes.Add(nodoTelefono); 
odoCategoria.Nodes.Add(nodoLetra); 


odoLetra = new TreeNode("B", 0, 1); 

nodoTelefono = new Tfno("Beatriz", "Santander", 942222222, 
also, "BEStriz", 0, 1)e 
odoLetra.Nodes.Add(nodoTelefono); 
odoCategoria.Nodes.Add(nodoLetra); 














odoCategoria = new TreeNode("Clientes", 0, 1); 
odoRaiz.Nodes.Add(nodoClategoria); 


odoLetra = new TreeNode("A", 0, 1); 

nodoTelefono = new Tfno("Antonio", "Granada", 956666666, 
rue, “Agromaio”., 0, 1)2 
odoLetra.Nodes.Add(nodoTelefono):; 
odoCategoria.Nodes.Add(nodoLetra); 

















Cuando el usuario seleccione un nodo de un árbol, se producirá, entre otros, el 
evento AfterSelect (ocurre una vez seleccionado el nodo). La respuesta a este 
evento será mostrar los datos relacionados con el nodo seleccionado. Añada, por 
lo tanto, el controlador de este evento y complételo como se indica a continua- 
ción: 


private void ArbolTfnos_AfterSelect(Object sender, 
TreeViewEventArgs e) 
( 
if (e.Node.GetType().Equals(Type.GetType("ArbolTfnos.Tfno"))) 
( 
Tfno nodo = (Tfno)e.Node; 


MessageBox.Show(nodo.datosTfno(), "Datos", 
MessageBoxButtons.OK, MessageBoxlIcon.Information):; 


El método anterior recibe en su argumento e, propiedad Node, el nodo selec- 
cionado (objeto TreeNode). Solo visualizaremos los datos esperados si este nodo 
es de la clase Tfno. ¿Cómo obtenemos esta información? Mediante el método 
GetType de la clase TreeNode. Este método devuelve un objeto de la clase Type 
que encapsula el tipo del objeto para el que es invocado; en nuestro caso el tipo 
debe ser “ArbolTfnos.Tfno”. Para poder realizar la comparación, construimos, a 
partir de la cadena de caracteres que describe el tipo esperado, un objeto Type in- 
vocando al método compartido GetType de esta clase. Finalmente, si el objeto es 
un objeto Tfno, se muestran los datos invocando al método datos Tfno de Tfno. 
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Otra solución sería acceder al nodo seleccionado a través de la propiedad Se- 
lectedNode de TreeView: 


if (ArbolTfnos.SelectedNode.GetType().Equals( 
Type.GetType("ArbolTfnos.Tfno"))) 
( 
Tfno nodo = (Tfno)ArbolTfnos.SelectedNode; 
MessageBox.Show(nodo.datosTfno(), "Datos", 
MessageBoxButtons.OK, MessageBoxlcon.Information); 


Recorrer todos los nodos del árbol 


Para recorrer todos los nodos del árbol empezando por la raíz, podemos escribir el 
método MostrarArbol que se muestra a continuación que, a su vez, invoca al mé- 
todo recursivo MostrarNodo. Recuerde que cada nodo tiene una colección Nodes 
donde almacena sus nodos hijo. 


private void MostrarArbol(TreeView arbol) 

( 

foreach (TreeNode unNodo in arbol.Nodes) 
MostrarNodo(unNodo); 


} 





private void MostrarNodo(TreeNode nodo) 
{ 
MessageBox.Show(nodo.Text); 
foreach (TreeNode unNodo in nodo.Nodes) 
MostrarNodo(unNodo); 








Añadir y borrar nodos 


Las operaciones de añadir y borrar un nodo de un árbol tienen en común que am- 
bas se ejecutarán sobre el nodo actualmente seleccionado. Si al ejecutar una de es- 
tas operaciones no hubiera un nodo seleccionado, la operación no se tendrá en 
cuenta. Las operaciones de añadir y borrar nodos serán más sencillas si contamos 
siempre con un nodo raíz; por eso, no permitiremos eliminarlo. 


Por otra parte, si nos fijamos en el árbol que presenta el explorador de Win- 
dows, sus nodos están colocados en orden alfabético ascendente. Nuestra aplica- 
ción, que simula un listín telefónico, necesita incorporar esta característica. Para 
ello, asigne a la propiedad Sort del control TreeView el valor true. No obstante, 
cuando se cambie el texto de un nodo existente, hay que llamar al método Sort 
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para reordenar el árbol. Este método emplea la ordenación especificada por la 
propiedad TreeViewNodeSorter. 


¿Cómo se obtiene una referencia al nodo seleccionado? En general, y según 
se ha expuesto anteriormente, a través de la propiedad SelectedNode de Tree- 
View. Utilizaremos este nodo como nodo padre de un nuevo nodo que podremos 
añadir invocando al método Add de la colección de nodos, o eliminarlo invocan- 
do al método Remove. También podremos eliminar todos los nodos borrando los 
elementos de la colección de nodos del nodo raíz. 


Para poner en práctica las operaciones descritas en el párrafo anterior, vamos 
a asociar con el árbol de nuestra aplicación ArbolTfnos un menú contextual como 
el siguiente: 












B- Teléfonos 
-D Amigos 








Añadir un nodo 












Borrar el nodo cionado 





Borrar todos los nodos excepto la raíz 


Para ello, siga los pasos indicados a continuación: 


1. Desde la barra de herramientas, añada un control ContextMenuStrip. Deno- 
mínelo, por ejemplo, menuContextualNodos (véase el capítulo 5). 


2. Añada al menú los tres elementos que muestra la figura anterior. Denomíne- 
los contextAñadirNodo, contextBorrarNodo y contextBorrarTodos. 


3. Para cada elemento del menú, añada su controlador de eventos Click. 


Una vez construido el menú contextual, pasamos a escribir los métodos que se 
ejecutarán cuando el usuario haga clic sobre cada una de las órdenes del mismo. 


Añadir un nodo 
Para añadir un nuevo nodo, el usuario primero hará clic utilizando el botón secun- 


dario del ratón sobre el nodo que va a ser padre del nodo a añadir y después, se- 
leccionará esta orden del menú. 
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Hacer clic con el botón secundario del ratón sobre un nodo no cambia la se- 
lección al mismo. Para hacerlo, responda al evento NodeMouseClick que se ge- 
nera después de esta acción, añadiendo el controlador siguiente: 


private void ArbolTfnos_NodeMouseClick(object sender, 
TreeNodeMouseClickEventArgs e) 
( 





// Se hizo clic con el botón secundario del ratón 

// sobre un nodo; seleccionarlo. 

if (e.Button == MouseButtons.Right) 
ArbolTfnos.SelectedNode = e.Node; 


A continuación, el clic sobre el elemento Añadir un nodo del menú contextual 
generará un evento Click al que la aplicación responderá ejecutando el método 
contextAñadirNodo Click indicado a continuación. Este método obtendrá, en 
primer lugar, una referencia al nodo seleccionado siempre y cuando no sea un no- 
do de la clase Tfno, ya que estos son nodos hoja. El nivel del nodo seleccionado 
permitirá conocer la clase de sus hijos: “categoría”, “letra” o “teléfono”. Enton- 
ces, según el nivel, solicitará los datos necesarios para crear el nodo, creará el no- 
do hijo adecuado con esos datos y lo añadirá al árbol invocando al método Add 
de su colección. 


Para solicitar al usuario los datos para crear el nodo, se le presentará la caja de 
diálogo que corresponda de las siguientes. Los tres son diálogos personalizados; 
por lo tanto, añada nuevos formularios a la aplicación y diséñelos siguiendo los 
pasos explicados en el capítulo 5. 


Dato categoria loli E) 


Catgoría: Aceptar 

















Dato letra leal A) 








Letra: Aceptar 


Cancelar 
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Nombre: Aceptar 
Teléfono: 0 
[E] Casado 











Según lo expuesto, el método contextAñadirNodo_ Click puede escribirse así: 


private void contextAñadirNodo_Click(object sender, EventArgs e) 
( 
if (ArbolTfnos.SelectedNode.GetType().Equals( 
Type.GetType("ArbolTfnos.Tfno"))) 
return; // El nodo seleccionado es un nodo de la clase Tfno 


// El nodo seleccionado no es un nodo de la clase Tfno 
TreeNode nodoPadre = ArbolTfnos.SelectedNode; 


// Crear el nodo hijo 

TreeNode nodoHijo = null; 
switch (nodoPadre.Level) 
( 








case 0: // raíz del árbol: añadir categoría 
string categoria = ""; 
Datolategoria dlgCategoria = new DatoCategoria():; 
if (dlgCategoria.ShowDialogí() == DialogResult.OK) 
categoria = dlgCategoria.ctCategoria.Text; 
if (categoria.Length != 0) 
nodoHijo = new TreeNode(categoria, 0, 1); 
break; 





case 1: // categoría: añadir letra 
string letra = ""; 
Datoletra dlgLetra = new DatolLetra(); 
if (dlgLetra.ShowDialog() == DialogResult.0K) 
letra = dlgletra.ctletra.Text; 
if (letra.Length != 0 
nodoHijo = new TreeNode(letra, 0, 1); 
break; 











case 2: // letra: añadir teléfono 

DatosNodo dlglTfno = new DatosNodo(); 

if (dlgTfno.ShowDialog() == DialogResult.0OK) 

( 
string nombre = dlglfno.ctNombre. Text; 
string direccion = dlglfno.ctDirec.Text; 
long telefono = System.Convert.Tolnt32(dlglfno.ctIfno.Text); 
bool casado = dlgTfno.cvCasado.Checked; 
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nodoHijo = new Tfno(nombre, direccion, 
telefono, casado, nombre, 0, 1); 
) 
break; 
default: 
return; 
) 
// Insertar el nodo en el árbol 
if (nodoHijo != null) 
nodoPadre.Nodes.Add(nodoHijo); 


Para poder editar las etiquetas de los nodos del árbol, ponga su propiedad La- 
belEdit a true. Para editar la etiqueta de un nodo tiene que seleccionar el nodo y, 
una vez seleccionado, hacer un clic sobre él; después, escriba la nueva etiqueta y 
pulse Entrar. 


ArbolTfnos.LabelEdit = true; 
Borrar el nodo seleccionado 


Para borrar un nodo, el usuario primero seleccionará el nodo y después hará clic 
en esta orden del menú contextual. Esta última acción generará un evento Click al 
que la aplicación responderá ejecutando el método contextBorrarNodo_ Click in- 
dicado a continuación. Este método obtendrá, en primer lugar, una referencia al 
nodo seleccionado y después, si no se trata del nodo raíz, lo borrará invocando al 
método Remove. 


private void contextBorrarNodo_Click(object sender, EventArgs e) 

( 
// Borrar el nodo seleccionado y sus descendientes, excepto la raíz 
if (ArbolTfnos.SelectedNode.Equals(ArbolTfnos.Nodes[0])) return; 
ArbolTfnos.SelectedNode.Remove():; 

) 


Borrar todos los nodos excepto la raíz 


Esta orden la ejecutará el usuario cuando quiera borrar todos los nodos del árbol, 
excepto la raíz. La selección de esta orden generará un evento Click, al que la 
aplicación responderá ejecutando el método contextBorrarTodos_Click indicado a 
continuación, el cual recorrerá la colección de nodos del nodo raíz invocando para 
cada uno de ellos al método Remove. Cuando Remove borra un nodo, quedan 
también eliminados sus descendientes. 


private void contextBorrarTodos_Click(object sender, EventArgs e) 
( 
// Borrar todos los nodos excepto la raíz 
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foreach (TreeNode nodo in ArbolTfnos.Nodes[0].Nodes) 
nodo.Remove():; 


Personalizar el aspecto de un árbol 


La figura del árbol Teléfonos mostrada unas páginas atrás visualiza por cada nodo 
un icono y un texto. Si además el nodo tiene descendientes, visualiza a su izquier- 
da un pequeño botón con un signo más (+) si el nodo está contraído, o con un 
signo menos (-) si el nodo está expandido. Esto es, el usuario puede expandir un 
nodo haciendo clic en el botón más y contraerlo haciendo clic en el botón menos. 
Así mismo, los nodos muestran su dependencia respecto de otros nodos con líneas 
de unión entre los mismos. Este aspecto puede ser modificado dentro de unos lí- 
mites. Algunas de las operaciones que podemos realizar para modificar el aspecto 
del árbol son las siguientes: 


e Los nodos del árbol pueden mostrar casillas de verificación estableciendo la 
propiedad CheckBoxes del TreeView a true. En este caso, la propiedad 
Checked de cada nodo indicará su estado activado o no activado. 


e La propiedad ShowPlusMinus tiene como valor predeterminado true. Si se 
pone a false, no se mostrará el botón con el signo más (+) o con el signo me- 
nos (-) al lado de cada nodo. 


e La propiedad ShowRootLines tiene como valor predeterminado true para 
mostrar las líneas que unen entre sí todos los nodos del árbol. 


e Sila propiedad HotTracking se pone a true, el aspecto de las etiquetas cam- 
biará a hipervínculo cuando el puntero del ratón pase sobre el nodo del árbol. 


e Sila propiedad ShowNodeToolTips de un control TreeView se pone a true, 
los nodos pueden mostrar una breve descripción, la que se ponga en la pro- 
piedad ToolTipText del nodo. 


VISTAS DE UNA LISTA 


Una lista de elementos puede mostrarse de una forma gráfica utilizando un control 
ListView. Por ejemplo, el explorador de Windows muestra una lista de los fiche- 
ros y carpetas de la carpeta seleccionada actualmente en el árbol. Cada carpeta 
muestra un icono asociado con ella y cada fichero también, para ayudar así a iden- 
tificar el tipo de fichero. 
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Un elemento de un control ListView es un objeto de la clase ListViewItem. 
Para mostrar estos elementos se pueden utilizar diferentes tipos de vistas: vistas 
en miniatura, mosaicos, iconos, lista y detalles. Esta información se proporciona a 
través de la propiedad View. Dichos elementos pueden ser seleccionados uno a 
uno o en grupos, dependiendo del valor de la propiedad MultiSelect. La propie- 
dad SelectedItems hace referencia a la colección que almacena los elementos se- 
leccionados y la propiedad Selectedindices hace referencia a la colección que 
almacena los índices de los elementos seleccionados. 


Los elementos también pueden tener subelementos que contengan informa- 
ción relacionada con el elemento primario. Por ejemplo, la vista en detalle permite 
mostrar el elemento y sus subelementos en una cuadrícula con encabezados de co- 
lumna que identifican la información mostrada de cada subelemento. 


Un control ListView está dotado de tres colecciones referenciadas por las 
propiedades Items, Columns y Groups. La colección Items contiene todos los 
elementos del control, Columns contiene todos los encabezados de columna que 
aparecen en el control, y Groups contiene objetos de la clase ListViewGroup; un 
objeto de esta clase representa un grupo de elementos de la lista. Mediante esta úl- 
tima colección podemos agrupar los elementos de la lista en diferentes categorías. 


Personalizar el aspecto de una vista 


Además de las propiedades mencionadas, hay otras muchas que le permitirán mo- 
dificar el aspecto de la vista mostrada por un control ListView. A continuación, 
citamos algunas de interés: LabelEdit indica si el usuario puede editar las etique- 
tas de los elementos, AllowColumnReorder especifica si el usuario puede cam- 
biar de posición las columnas del control arrastrándolas, CheckBoxes indica si 
aparece una casilla de verificación al lado de la etiqueta, FullRowSelect especifi- 
ca si al hacer clic en un elemento de la lista la selección se extiende también a to- 
dos sus subelementos en una vista de detalle, GridLines especifica si aparecen 
líneas entre las filas y las columnas y Sorting especifica el tipo de ordenación que 
se aplica a los elementos que muestra la vista: ascendente, descendente o ninguno. 
Estas propiedades puede fijarlas durante el diseño o durante la ejecución. 


El ejemplo que se escribe a continuación muestra el código necesario para vi- 
sualizar el objeto ListView de la figura siguiente: 





Columna 1 Columna 2 Columna 3 
oO © Elemento 1 Subelemento 1.1  Subelemento 1.2 


Subelemento 2.1 | Subelemento 2.2 
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Para entender este ejemplo, suponga que ha añadido a un formulario un objeto 
ListView denominado listViewl: 



















































































// Fijar la vista de detalles 
istViewl.View = View.Details; 
// Permitir editar etiquetas 
istViewl.LabelEdit = true; 
// Permitir colocar columnas 
istView1.AllowColumnReorder = true; 
// Mostrar casillas de verificación 
istViewl.CheckBoxes = true; 
// Incluir selección de elementos 
istViewl.FullRowSelect = true; 
// Mostrar líneas 
istViewl.GridlLines = true; 
// Mostrar los elementos en orden ascendente 
istViewl.Sorting = SortOrder.Ascending; 
// Crear las columnas 
istViewl.Columns.Add("Columna 1", -2, HorizontalAlignment.Left); 
istView1.Columns.Add("Columna 2", -2, HorizontalAlignment.Left); 
stViewl1.Columns.Add("Columna 3", -2, HorizontalAlignment.Left); 
// Crear dos elementos y sus subelementos 
ListViewItem elementol = new ListViewltem("Elemento 1", 0); 
elementol.Subltems.Add("Subelemento 1.1"); 
elementol.Subltems.Add("Subelemento 1.2"); 
ListViewItem elemento2 = new ListViewltem("Elemento 2", 0); 
elemento2.Subltems.Add("Subelemento 2.1"); 
elemento2.Subltems.Add("Subelemento 2.2"); 
// Añadir los elementos al control listView 
istViewl.Items.AddRange(new ListViewItem[] { elementol, elemento2 }); 
// Crear dos objetos ImagelList, iniciarlos y asignarlos al ListView 
ageList imagsPequeñas = new ImageLlist(); 
agelist imagsGrandes = new ImageList(); 
agsPequeñas.Images.Add(Image.FromFile 
"..AN..ANImagenesMCarpetaAbierta.png")); 
agsGrandes.Images.Add(Image.FromFile(l 
"JAN. \ Imagenes \\CarpetaAbiertaGrande.png")); 
istViewl.LargeImageList = imagsGrandes; 
istViewl.SmallImageList = imagsPequeñas; 





La colección Columns 


Esta colección solo tiene sentido cuando se muestra una vista en detalle. Para 
mostrar los elementos de una vista en detalle, primero hay que configurar las co- 
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lumnas adecuadas. La primera columna corresponde al elemento y las siguientes a 
sus subelementos. Una vista en detalle exige que se configure, al menos, una co- 
lumna, de lo contrario, no se mostrará ningún elemento. Por ejemplo, el código 
siguiente añade tres columnas: 


listView1.Columns.Add("Columna 1", -2, HorizontalAlignment.Left):; 
listView1.Columns.Add("Columna 2", -2, HorizontalAlignment.Left):; 
listView1.Columns.Add("Columna 3", -2, HorizontalAlignment.Left); 


Obsérvese que al método Add se le pasan tres argumentos: el encabezado de 
la columna, un valor —2 para que el ancho se ajuste automáticamente al tamaño 
del texto del encabezado y la alineación del texto. Con estos argumentos se crea 
un objeto ColumnHeader que se agrega a la colección Columns. Esto es, la pri- 
mera línea del código anterior sería equivalente a: 


ColumnHeader ColumnHeaderl = new ColumnHeader(""); 
ColumnHeader1l.Text = "Columna 1"; 
ColumnHeader1.Width = -2; 

ColumnHeader1.TextAlign = HorizontalAlignment.Left; 
listVviewl1.Columns.Add(ColumnHeaderl1)'; 





Elemento de la lista 


Igual que sucede con el control TreeView, el control ListView puede construirse 
total o parcialmente durante el diseño o durante la ejecución. 


Para añadir elementos durante el diseño, seleccione el control ListView, dirí- 
jase a la ventana de propiedades, seleccione la propiedad Items y haga clic en el 
botón mostrado a la derecha. Se mostrará la ventana siguiente, en la que podrá 
añadir los elementos y subelementos que desee. 


Y para crearlos durante la ejecución escriba código similar al siguiente: 


ListViewItem elementol = new ListViewltem("Elemento 1", 0); 
elementol.Subltems.Add("Subelemento 1.1"); 
elementol.Subltems.Add("Subelemento 1.2"); 


Obsérvese que al constructor ListViewltem se le pasa como primer argumen- 
to la etiqueta del elemento y como segundo el índice en la colección de imágenes 
de la imagen que se mostrará. Los subelementos se añaden a la colección Subl- 
tems del elemento. 


CAPÍTULO 7: TABLAS Y ÁRBOLES 271 


























A = My 
Editor de la colección ListViewltem [EAS 
Miembros: Propiedades de ListViewltem: (): 
[o ListViewltem: {} i + B, 
4 Apariencia s 
y BackColor Window | 
Checked False 
Font Microsoft Sans Serif; 
ForeColor E windowtext 
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ToolTipText = 


UseltemStyleForSu True 
4 Comportamiento 





























Group (ninguno) 
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La colección Items 


Todos los elementos de un control ListView están almacenados en su colección 
Items. Podemos añadir un elemento a la colección utilizando el método Add o 
una matriz de elementos utilizando el método AddRange. 


listViewl.Items.AddRange(new ListViewltem[] { elementol, elemento2 )); 


Un ejemplo con ListView, TreeView y SplitContainer 


Como ejemplo, vamos a ampliar la aplicación anterior añadiendo a la derecha del 
árbol un ListView para que muestre la información almacenada por los nodos. La 
información mostrada se corresponderá con los objetos Tfno contenidos en la co- 
lección Nodes del nodo seleccionado. Dicha información se mostrará en una vista 
en detalle con las columnas nombre, dirección, teléfono y casado(a). 


Estamos ante un diseño donde una selección en un control determina qué ob- 
jetos se muestran en otro control. Por lo tanto, sería útil disponer de dos paneles, 
el de la izquierda para agregar el árbol de nodos y el de la derecha para agregar la 
lista que mostrará la información del nodo seleccionado en el árbol, así como una 
barra o divisor que facilite al usuario la tarea de cambiar el tamaño de los dos pa- 
neles. Precisamente, el control SplitContainer (que reemplaza al control Splitter 
de versiones anteriores de Windows Forms) es un elemento compuesto de dos pa- 
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neles separados por una barra movible. Cuando el puntero del ratón está encima 
de la barra, cambia de forma para indicar que se puede modificar el tamaño de los 
paneles y, por lo tanto, de su contenido. 


Según lo expuesto, añada al formulario Form1 un control SplitContainer y a 
continuación, agregue el control TreeView en el panel de la izquierda y el control 
ListView en el de la derecha, ambos totalmente acoplados (propiedad Dock igual 
a Fill) al contenedor. 


f z 
al Árbol y lista teléfonos bakk 





5- Teléfonos Nombre Dirección Teléfono 


E | Amigos] 
a e a © Afons Barcelona 933333333 


Dana Pontevedra 986666666 
O Beatriz Santander 942222222 














Para añadir un control ListView al formulario, arrástrelo desde la caja de he- 
rramientas de Visual Studio. A continuación, personalícelo estableciendo las pro- 
piedades que desee según lo expuesto anteriormente. 


Después, diríjase a la ventana de propiedades, seleccione la propiedad Co- 
lumns y haga clic en el botón mostrado a la derecha. En la ventana que se muestra 
añada las columnas nombre, dirección, teléfono y casado que se mostrarán en el 
caso de seleccionar la vista de detalle. 


Después, desde la caja de herramientas, añada un control ImageList para las 
imágenes grandes; denomínelo imagsGrandes. Las imágenes pequeñas las toma- 
remos del control imagsNodos. 


Asigne a las propiedades LargelmageList y SmalllmageList del ListView 
los controles ¿magsGrandes e imagsNodos, respectivamente. 


Después, modifique el método ArbolTfnos AfterSelect como se indica a con- 
tinuación: 


private void ArbolTfnos_AfterSelectí(object sender, 
TreeViewEventArgs e) 
( 
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listviewTfnos.Items.Clear(); 
listviewTfnos.View = View.Details; 
if (e.Node.GetType().Equals(Type.GetType("ArbolTfnos.Tfno"))) 
Mostrar((Tfno)e.Node); 
else 
foreach (TreeNode unNodo in ArbolTfnos.SelectedNode.Nodes) 
RecorrerArbol(unNodo); 








Este método lo primero que hace es borrar todos los elementos de la lista y fi- 
jar la vista en detalle. Después, si el nodo seleccionado es un objeto Tfno, invoca a 
Mostrar para visualizar sus atributos en la lista; en otro caso, invoca al método 
RecorrerArbol pasando como argumento el nodo seleccionado. 


private void RecorrerArbol(TreeNode nodo) 
( 
if (nodo.GetType().Equals(Type.GetType("ArbolTfnos.Tfno"))) 
Mostrar((Tfno)nodo); 
foreach (TreeNode unNodo in nodo.Nodes) 
RecorrerArbol(unNodo); 


El método RecorrerArbol es recursivo. Su función es recorrer todos los nodos 
del subárbol que tiene por raíz el nodo que recibe en su parámetro nodo y mostrar 
en la lista los atributos de aquellos que sean de la clase Tfno. 


private void Mostrar(Tfno nodo) 
( 


ListViewltem elemento = new ListViewltemí(nodo.nombre, 0); 


emento.Subltems.Add(nodo.dirección); 
lemento.Subltems.Add(nodo.teléfono.ToString()); 
ring casado = "No"; 

(nodo.casado) casado = "Sí"; 
lemento.Subltems.Add(casado); 
istviewTfnos.Items.Add(elemento); 











=0M0 0D. (D 


Este otro método crea un elemento ListViewItem a partir de los atributos del 
objeto Tfno que recibe en su parámetro nodo y lo añade a la lista. 


Finalmente, modifique el método contextBorrarTodos_ Click como se indica a 
continuación, porque si se ejecuta siendo el nodo seleccionado la raíz, no habría 
cambio a otra selección, no se ejecutaría ArbolTfnos AfterSelect y no se borraría 
el control ListView. 


private void contextBorrarfodos_Click(object sender, EventArgs e) 
( 
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e yea 
if (ArbolTfnos.SelectedNode.Equals(ArbolTfnos.Nodes[0])) 
listviewTfnos.Items.Clear(); 


EJERCICIOS RESUELTOS 


Para ver con detalle la manera de utilizar una rejilla, vamos a desarrollar una apli- 
cación que, a partir de los datos crédito, tiempo de amortización y tipo de interés 
al que se presta el mismo, visualice el pago mensual que debemos realizar para 
amortizar dicho crédito y la tabla de amortización mes a mes hasta la finalización 
del período del préstamo. 


La aplicación deberá reunir fundamentalmente las siguientes características: 
e Instrucciones para manipular la aplicación. 
e El período de tiempo podrá venir dado en meses o en años. 


e El pago mensual a calcular podrá visualizarse para más de un período y 
para más de un tipo de interés. 





10 años 11 años a 
2,00 % 1.656,24 1.520,26 
2,50 % 1.696,86 1.561,13 


> 30% 1.738,09 1.602,68 


e La tabla de amortización incluirá por cada mensualidad su desglose en 
capital e intereses, el capital pendiente después de realizar ese pago y el 
total de los intereses pagados hasta ese momento. 





Capital Intereses z 
TE s| 
2 1.291,31 446,78 

3 1.294,54 443,55 


La figura siguiente muestra el aspecto final de la aplicación. Observe, además 
de lo expuesto anteriormente, otros detalles, como una lista desplegable para fijar 
el incremento del intervalo de tipos de interés y las barras de desplazamiento. 
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Opciones Préstamo en... Ayuda 


Crédito: 180000 


1.656,24 
Años del préstamo 
1.696,86 


Mínimo: 1.779,95 | 

| 1.822,41 | 
Tipos de interés 1.865,49 | 1.731,37 
% máximo: i ' 1.909,18 | 1.775:81 | 
1.953,47 | 1.820,51 | 
1.998,37 1.866,07 Ll 
Incremento: 0.50 2.043,86 | 1.912,28 
| 2.089.95 | 1.959,14 
2.136,63 | : 
2.183,90 | 


% mínimo: 























Para empezar, cree una nueva aplicación denominada Prestamo que utilice un 
formulario de la clase Form como ventana principal. 


Asigne a la ventana el título Préstamo bancario, un tamaño de 485x385 y 
ponga su propiedad FormBorderStyle a valor Fixed3D para que no se pueda re- 
dimensionar la ventana, y su otra propiedad MaximizeBox a false para que no se 
pueda maximizar. Si también asigna a su propiedad Name el valor Prestamo, la 
clase Forml pasará a denominarse Prestamo. 


A continuación, añada los menús Opciones y Préstamo en..., con las órdenes 
que se especifican en la tabla siguiente: 
X 


Propiedad 
| Separador | Name |OpcionesSeparadorl 


Text &Instrucciones... 
Name 

i Name OpcionesSalir 
Name 
Text 
Name 


X 


Préstamo en... menuPrestamoEn 
xX &Préstamo en... 
Años N PrestamoEnAños 
Text &AÑños 
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Meses Name PrestamoEnMeses 
Text S£Meses 


Name 


Text 


Acerca de Name AyudaAcercaDe 
Text &Acerca de Préstamo... 


menuAyuda 
S£Ayuda 





El código siguiente describe de forma simplificada la clase y los controles 
añadidos después del diseñado en base a lo descrito en la tabla anterior: 


partial class Prestamo 


( 
1/ 





priv 
priva 
priv 
priv 
priva 
priv 
priva 
priv 
priv 
pri 











Menu 
Too] 
Too] 
Too] 
700] 
Too] 
700] 
Too] 
Too] 
Too] 








Stri 


NAM MN MUNI UM 





¿ES ¿ig oe dz I iS tm E Sl ra INS E El 7 is o DA 

















BarraDeMenus; 


tem Opciones 


tem Prestamo 
tem Prestamo 











u 
u 
a 
u 
ultem menuPres 
u 
u 
u 
u 











tem AyudaAce 


tem menuAyuda; 


tem menu0pciones; 


nstruc; 


rator OpcionesSeparadorl; 
tem OpcionesSalir; 


tamoEn; 
EnAÑOS; 
EnMeses; 





caDe; 


Ahora, siguiendo los pasos estudiados al principio de este capítulo, añada una 
tabla (objeto DataGridView) y establezca sus propiedades: 


Name 
AllowUserToAddRows 
AllowUserToDeleteRows 
AllowUserToResizeRows 
AutoSizeColumnsMode 


Tabla 


ColumnHeadersDefaultCellStyle 
ColumnHeadersHeightSizeMode 
DefaultCellStyle 
RowHeadersWidth 
RowHeadersWidthSizeMode 
ScrollBars 





tablaPrestamo 

false 

false 

false 

None 
Alignment:MiddleCenter 
AutoSize 
Alignment:MiddleRight 
90 
AutoSizeToAllHeaders 
Both 


La inclusión de una tabla del tipo indicado genera el siguiente código: 


private System.Windows.Forms.DataGridView tablaPrestamo; 


des 
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tablaPrestamo = new DataGridView(); 
tablaPrestamo.Name = "tablaPrestamo"; 
FA ei 


A continuación, añada el resto de los controles especificados en la tabla si- 
guiente (el código completo lo encontrará en la carpeta Cap07|Resueltos|Pres- 
tamo del CD que acompaña al libro): 


Text Crédito: 
Caja de texto 1 Name ctCredito 
TextAlign Right 
Text (nada) 
Text Duración del préstamo 
Text Máximo: 
Caja de texto 2 Name ctPeriodoMax 
e extAlign Right 
ext (nada) 
Minimo: 


Caja de texto 3 ame ctPeriodoMin 
extAlign Right 
(nada) 








Text 
Text Tipo de interés 
Text % máximo: 
Caja de texto 4 Name ctInteresMax 
SEBAS extAlign Right 
ext (nada) 
Text % minimo: 
Caja de texto 5 Name ctInteresMin 
TextAlign Right 
Text (nada) 
Text Incremento: 
DropDownStyle | DropDown 
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Botón de pulsación | Name btCalculoPagos 
Text Pagos 


Botón de pulsación | Name btCalculoAmort 
Text Amortización 
Enabled false 





Suponiendo definidas las variables indicadas en la tabla anterior, a continua- 
ción se muestra, a modo de ejemplo, el código para añadir algunos de los compo- 





















































nentes: 
etlLabell.AutoSize = true; 
etlabell.lLocation = new Point(13, 37); 
etlabell.Name = "etLabell"; 
etLabell.Size = new Size(44, 14); 
etLabell.TabIndex = 6; 
etLabell.Text = "Crédito:"; 
ctCredito.Location = new Point(63, 37); 
ctCredito.Name = "ctCredito" 
ctCredito.Tablndex = 0 
ctCredito.TextAlign = HorizontalAlignment.Right; 
cgDuracionPrestamo.Controls.Add(ctPeriodoMin); 
cgDuracionPrestamo.Controls.Add(etLabel3); 
cgDuracionPrestamo.Controls.Add(ctPeriodoMax); 
cgDuracionPrestamo.Controls.Add(etLabel2); 
cgDuracionPrestamo.ForeColor = SystemColors.ControlText; 
cgDuracionPrestamo.Location = new Point(8, 72); 
cgDuracionPrestamo.Name = "cgDuracionPrestamo"; 
cgDuracionPrestamo.Size = new Size(155, 81); 
cgDuracionPrestamo.TabIndex = 1; 
cgDuracionPrestamo.TabStop = false; 
cgDuracionPrestamo.Text = "Duración del préstamo"; 
/1 
sdIncremento.FormattingEnabled = true 
sdIncremento.Items.AddRange(new Object[] 


EOL Oo OO TOO) 
sdIincremento.Location = new Point(78, 74); 
sdIincremento.Name = "IsdIncremento"; 

sdIncremento.Size = new Size(70, 21); 
sdIncremento.TabIndex = 2; 











/1 


btCalculoAmort.Enabled = false; 
btCalculoAmort.Location = new Point(14, 316); 
btCalculoAmort.Name = "btCalculoAmort"; 


CAPÍTULO 7: TABLAS Y ÁRBOLES 279 


btCalculoAmort.Size = new Size(149, 23); 
btCalculoAmort.Tablndex = 4; 
btCalculoAmort.Text = "Amortización"; 

/1 





Según vimos en el capítulo 3, la caja de texto ctCredito quedará enfocada 
cuando se inicie la aplicación por haber asignado a su propiedad TabIndex un va- 
lor cero; como allí se explicó, esto puede hacerlo a través de la ventana de propie- 
dades, o bien ejecutando la orden Ver > Orden Tab. 


Sobre el código anterior cabe destacar algunas cosas de interés: una, cómo se 
añade a la interfaz gráfica un marco con título (fíjese en el marco definido por el 
borde de cgDuracionPrestamo); otra, cómo iniciar una lista desplegable con unos 
valores determinados (fíjese en el control /sdIncremento); finalmente, observe el 
código correspondiente al botón btCalculoAmort;, este botón se presenta inicial- 
mente inhabilitado. 


Después de hacer las operaciones indicadas, el resultado será similar al pre- 
sentado en la siguiente figura: 


Opciones Préstamo en... Ayuda 


Crédito: 





Iniciar la tabla 


El diseño inicial que hemos realizado de la ventana Préstamo bancario no incluye 
en la tabla ni filas ni columnas. Lo que deseamos es que esta tabla presente una 
cabecera de columnas para indicar los períodos de amortización, y una cabecera 
de filas, como se puede observar en la figura siguiente, para indicar los tipos de 
interés: 
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Opciones Préstamo en... Ayuda 


Crédito: Columna 2 


Años del préstamo 


Máximo: 
Minimo: 

Tipos de interés 
% máximo: 


% mínimo: 





Incremento: 

















El hecho de añadir una columna a la tabla lleva implícito añadir la cabecera 
de color gris y lo mismo diremos para las filas. 


Para añadir una columna simplemente tenemos que crear un objeto Data- 
GridViewTextBoxColumn e incluirlo a la colección Columns de la tabla, y para 
añadir una fila, creamos una matriz de tipo string con tantos elementos como co- 
lumnas y la incluimos en la colección Rows de la tabla. El método IniciarTabla 
escrito a continuación permite construir una tabla con las filas y columnas pasadas 
como argumentos cuando este sea invocado: 


private void IniciarTabla(int filas, int cols) 
( 
int $. C; 
DataGridViewTextBoxColumn Columna; 
// Añadir columnas a la tabla 
for (c= 1; c <= cols; c++) 
( 
Columna = new DataGridViewTextBoxColumn():; 
Columna .HeaderText = "Columna " + cC; 
Columna.Width = 93; 
Columna.Read0nly = true; 
Columna.SortMode = DataGridViewColumnSortMode.NotSortable; 
tablaPrestamo.Columns.Add(Columna) ; 
) 
// Añadir filas a la tabla 
string] fila = new string[cols + 1]; 
for (f = 1; f <= filas; f++) 
tablaPrestamo.Rows.Add(fila); 
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El modelo de datos empleado para la tabla préstamo define una matriz para 
almacenar los datos por cada fila de la tabla, y las agrupa bajo la colección Rows 
de dicha tabla. Así mismo, recuerde que para acceder a los datos de una celda in- 
dividual puede hacerlo a través de la expresión: 


tablaPrestamo.Rows[f].Cells[c].Value; 


O bien, si se trata de acceder a la celda actualmente seleccionada, a través de 
la expresión: 


tablaPrestamo.CurrentCell.Value; 
Iniciar la ventana de la aplicación 


El siguiente paso es añadir el código necesario para que nuestra aplicación realice 
las funciones especificadas anteriormente. En primer lugar, vamos a pensar en lo 
que deseamos que ocurra cuando se inicie la ejecución de la aplicación. Esto pue- 
de resumirse en los puntos siguientes: 


e Por estética, colocaremos la ventana en el centro de la pantalla utilizando la 
propiedad StartPosition del formulario, a la que asignaremos el valor Cen- 
terScreen del tipo enumerado FormStartPosition. Este método tiene un ar- 
gumento de tipo Component que se toma como referencia para colocar la 
ventana. Si este argumento es null, la ventana se colocará centrada en la pan- 
talla. Para ello, añada al constructor de la clase Prestamos el código siguiente: 


StartPosition = FormStartPosition.CenterScreen; 


e [Ia lista desplegable /sdIncremento hay que llenarla con los incrementos que 
estimemos convenientes; por ejemplo, 0,1; 0,25; 0,5 y 1, operación que ya hi- 
cimos anteriormente durante el diseño de la interfaz gráfica, pero podríamos 
hacerlo, si quisiéramos, al iniciar la ejecución de la aplicación. 


IsdIincremento.Items.AddRange(new Objectl[] 
LEO IO OL ODO ML 0074) 


e  Latabla, control DataGridView, por estética la vamos a iniciar con un núme- 
ro de filas y columnas predeterminado. En nuestro caso lo vamos a hacer, in- 
vocando al método IniciarTabla, con los argumentos 18 filas y 4 columnas. 
Después, cada vez que se hagan cálculos de pagos o de amortización, la vol- 
veremos a iniciar, lo que garantiza que todas las celdas se borrarán. Estos va- 
lores pueden recuperarse en cualquier instante por medio de las propiedades 
RowCount y ColumnCount de la tabla. 
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Dos valores que definen la celdas editables de la tabla son el número de tipos 
de interés (los tipos de interés se mostrarán en las cabeceras de las filas) y el 
número de años o de meses del préstamo (los meses o años aparecerán en las 
cabeceras de las columnas). Estos valores variarán durante la ejecución de la 
aplicación en función del intervalo y del incremento elegido para los tipos de 
interés, y del intervalo elegido para la duración del préstamo. Por lo tanto, 
almacenaremos estos valores en las variables fiposIntrs y añosMeses que de- 
finiremos como atributos privados de tipo int de la clase Prestamo. El prime- 
ro lo iniciaremos con el valor predeterminado para las filas no fijas, 18, y el 
segundo con el valor predeterminado para las columnas no fijas, 4. 


Asumiremos, por omisión, que la duración del préstamo viene dada en años. 
Esto implica dejar inhabilitada la orden 4ños del menú Préstamo en..., (por- 
que ya ha sido elegida), habilitar la orden Meses (para que se pueda elegir) y 
poner al marco “Duración del préstamo” el título “Años del préstamo”. 


Iniciamos las cajas de texto con unos datos simbólicos y la lista desplegable 
con el valor 0,5 (elemento de índice 2). 


Finalmente, invocamos al método iniciarTabla para construir la tabla. 


Según lo expuesto, edite el controlador para el evento Load del formulario 


Prestamo como se indica a continuación: 


private void Prestamo_Load(object sender, EventArgs e) 


( 


StartPosition = FormStartPosition.CenterScreen; 
tiposIntrs = 18; 

añosMeses = 4; 

PrestamoEnAños.Enabled = false; 


cgDuracionPrestamo.Text = "Años del préstamo"; 
ctCredito.Text = "6000"; 

ctPeriodoMax.Text = "1"; 

ctPeriodoMin.Text = "1"; 

ctinteresMax.Text = "7,00"; 


ctIinteresMin.Text = "0,00"; 
IsdIncremento.SelectedIindex = 2; 
IniciarTabla(tiposIntrs, añosMeses); 














Manejo de la aplicación 


Una vez que tengamos visualizada la ventana, quizás el usuario necesite instruc- 
ciones acerca del manejo de la aplicación. Esta ayuda la implementaremos a tra- 
vés de la orden Instrucciones del menú Opciones, de forma que cuando el usuario 
ejecute dicha orden, se visualice una ventana con los pasos a seguir. Para ello, 
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añada el controlador de eventos Click de la orden Instrucciones y complételo co- 
mo se indica a continuación: 


private void OpcionesInstruc_Click(object sender, EventArgs e) 
( 




















string mensaje; 
string NL = Environment .NewLine; 
mensaje = "Introduzca el crédito, la duración del préstamo y el tipo" + NL; 
mensaje += "de interés. Pulse el botón [Pagos] para visualizar" + NL; 
mensaje += "los pagos mensuales en la rejilla." + NL + NL; 
mensaje += "Elija un pago mensual y pulse el botón [Amortización]" + NL; 
mensaje += "para visualizar el plan de amortización para el interés" + NL; 
mensaje += "y períodos correspondientes al pago elegido." + NL + NL; 
mensaje += "Para copiar datos en el portapapeles, seleccione las celdas” + NL; 
mensaje += "que desee y pulse las teclas Ctrl+c." + NL; 
essageBox.Show(mensaje, "Instrucciones", MessageBoxButtons.0K, 

MessageBox1Icon. Information); 





El resultado de ejecutar el método anterior será la ventana siguiente: 





f . ' Introduzca el crédito, la duración del préstamo y el tipo 
W de interés. Pulse el botón [Pagos] para visualizar 


los pagos mensuales en la rejilla. 


Elija un pago mensual y pulse el botón [Amortización] 
para visualizar el plan de amortización para el interés 
y períodos correspondientes al pago elegido. 


Para copiar datos en el portapapeles, seleccione las celdas 
que desee y pulse las teclas Ctrl+c, 





El siguiente paso es introducir los datos crédito, duración del préstamo y ti- 
pos de interés. Ahora bien, la duración del préstamo, ¿son meses o años? Este 
concepto puede definirlo el usuario a través de las órdenes Años y Meses del me- 
nú Préstamo en... El método asociado con estas órdenes inhabilitará la duración 
Años o Meses elegida, habilitará la no elegida para que pueda elegirse la próxima 
vez y pondrá en el marco que titulamos Duración del préstamo un nuevo título, 
Años del préstamo o Meses del préstamo, acorde con la elección realizada. Proce- 
diendo de forma análoga a como lo hicimos con la orden Instrucciones, añada el 
controlador de eventos Click de la orden PrestamoEnAños. Ídem para la orden 
PrestamoEnMeses. En ambos casos, la respuesta será la ejecución del método 
PrestamoEnAñosMeses Click presentado a continuación: 
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private void PrestamoEnAñosMeses_Click(object sender, EventArgs e) 
( 
ToolStripMenultem ordenMenu = (ToolStripMenultem)sender; 


string tituloMarco = $ 


if (ordenMenu.Name == "PrestamoEnAños") 
{ 
PrestamoEnAños.Enabled = false; 
PrestamoEnMeses.Enabled = true; 
tituloMarco = "Años del préstamo"; 
) 
else if (ordenMenu.Name == "PrestamoEnMeses") 
( 
PrestamoEnAños.Enabled = true; 
PrestamoEnMeses.Enabled = false; 
tituloMarco = "Meses del préstamo”; 
) 
cgDuracionPrestamo.Text = tituloMarco; 








La caja de texto ctCredito recoge la cantidad prestada que almacenaremos en 
la variable credito de tipo double. 


Las cajas de texto ctPeriodoMax y ctPeriodoMin contienen, respectivamente, 
la duración máxima y mínima del préstamo, que almacenaremos en las variables 
periodoMax y periodoMin de tipo int. 


Las cajas de texto ctInteresMax y ctInteresMin contienen, respectivamente, 
el tipo de interés máximo y mínimo del préstamo, que almacenaremos en las va- 
riables interesMax e interesMin de tipo double. 


Después de los datos anteriores, el usuario seleccionará un elemento de la lis- 
ta desplegable IsdIncremento, cuyo valor almacenaremos en la variable incremen- 
to de tipo double. Este valor se corresponde con el incremento a aplicar para 
obtener los tipos de interés entre el mínimo y el máximo especificados. 


Defina las variables anteriores como atributos privados de la clase Prestamo 
según se indica a continuación: 


private double credito; 

private int periodoMax, periodoMin; 
private double interesMin, interesMax; 
private double incremento; 


Una vez introducidos todos los datos, el usuario hará clic en el botón Pagos 
(el botón Amortización, lógicamente, está inhabilitado). Como respuesta, se ejecu- 
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ta el método btCalculoPagos Click, que asociaremos con este botón. Este método 
tiene como finalidad: 


Obtener de los controles los datos introducidos y verificarlos. 


Calcular el número de tipos de interés y de períodos a partir de los datos in- 
troducidos. 


Crear la tabla con un número de filas igual al número de tipos de interés y con 
un número de columnas igual al número de períodos. La fila y columna fija 
son añadidas automáticamente. Los valores mínimos de filas y de columnas 
de la tabla serán siempre los valores de los que partimos inicialmente. 


Mostrar en la columna fija (color gris) los tipos de interés. 
Mostrar en la fila fija (color gris) las distintas duraciones del préstamo. 


Calcular los pagos mensuales para cada período y tipo de interés reflejados en 
la tabla. 


Mostrar los pagos calculados redondeados a dos cifras decimales y ajustados 
a la derecha. 


Finalmente, para indicar que la tabla mostrada es la de pagos y no la de amor- 
tización, pondrá a true la variable tablaPagos. Añada esta variable a la clase 
Prestamo como atributo privado de la misma e iníciela a false. 


private void btCalculoPagos_Click(object sender, EventArgs e) 


( 


// Actualizar las variables con los valores de los controles 
try 
( 

credito = double.Parse(ctCredito.Text); 

periodoMin = int.Parse(ctPeriodoMin.Text); 

periodoMax = int.Parse(ctPeriodoMax.Text); 

interesMin = double.Parse(ctIinteresMin.Text); 

interesMax = double.Parse(ctIinteresMax.Text); 

incremento = double.Parse(IsdIncremento. Text); 

// Comprobar que los datos son válidos 

if (credito <= 0 || periodoMin <= 0 || periodoMax <= 0 || 

periodoMax < periodoMin interesMin < 0 || 

interesMax < 0 || interesMax < interesMin) 
throw new FormatException(); 

















) 
catch (FormatException) 


( 
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MessageBox.Show("Datos no válidos", "Error", 
MessageBoxButtons.0OK, MessageBoxIcon.Error); 


return; 


) 


// Calcular el n° de tipos de interés y de períodos 
tiposintrs = System.Convert.Tolnt32( 

((interesMax - interesMin) / incremento) + 1); 
añosMeses = (periodoMax - periodoMin) + 1; 


// Tamaño mínimo de la tabla: los valores iniciales 
int filas = tiposintrs; 

int cols = añosMeses; 

if (tiposIntrs < 18) 





filas = 18; 
if (añosMeses < 4) 
cols = 4; 


// Crear de nuevo la tabla 
tablaPrestamo.Columns.Clear(); 
niciarTabla(filas, cols); 








// Almacenar en la columna fija los tipos de interés 
string s; 
s = string.Format("(0,5:P2)", interesMin / 100); 
tablaPrestamo.RowsL0].HeaderCell.Value = s; 

for (int f = 1; f <= tiposlntrs - 1; f++) 

( 





s = string.Format("(0,5:P2)", (interesMin + incremento * f) / 100); 
tablaPrestamo.Rows[f].HeaderCell.Value = s; 
) 





// Almacenar en la fila fija las distintas duraciones del préstamo 
string periodo = " años"; 

if (PrestamoEnAños.Enabled) 

periodo = " meses"; 

for (int c = 0; c <= añosMeses - 1; c++) 
tablaPrestamo.Columns[c].HeaderText = (periodoMin + c) + periodo; 








// Los períodos ¿en qué vienen dados? ¿En años o en meses? 
mit. Po =0% 

if (lPrestamoEnAños.Enabled) 

P = 12; // son años 

else 

P = 1; // son meses 





// Calcular pagos 
double interes = 0.0; 
double pagoMensual = 
int meses; 


0.0; 
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for (int f = 0; f <= tiposlntrs - 1; f++) 
( 
// Obtener el tipo de interés de la fila actual 
string sinteres = tablaPrestamo.Rows[f].HeaderCel1l.Value.ToString(); 
sinteres = sinteres.Substring(0, sinteres.Index0f(*%”)); 
interes = double.Parse(sinteres) / 100 / 12; 
// Calcular los pagos para este tipo de interés 
for (int c = 0; c <= añosMeses - 1; c++) 


( 








// Obtener la duración del préstamo 
string smeses = tablaPrestamo.Columns[c].HeaderText; 
smeses = smeses.Substring(0, smeses.Index0f(”* ?)); 
meses = int.Parse(smeses) * P; 
// Calcular la cantidad a pagar mensualmente 
if (interes == 0.0) 
pagoMensual = credito / meses; 
else 
pagoMensual = credito * (interes / (1 - (1 / (Math.Pow( 
1.0 + interes, System.Convert.ToDouble(meses)))))); 
// Ponerla en la tabla (se redondea a dos decimales) 
s = string.Format("(0,14:N2)", pagoMensual); 
tablaPrestamo.Rows[f].Cells[c].Value = s; 
} 
) 
tablaPagos = true; 


} 





Cuando la rejilla visualiza la cantidad a pagar mensualmente para cada perio- 
do y tipo de interés, el usuario puede seleccionar una de las celdas haciendo clic 
en ella, con el fin de visualizar la tabla de amortización para el crédito, en el pe- 
ríodo y tipo de interés a los que corresponde la mensualidad elegida. Como res- 
puesta a este evento, se ejecuta el método tablaPrestamo_CellClick. Este método 
obtendrá el dato de la celda sobre la que el usuario hizo clic, lo almacenará en la 
variable pagoMensual, y activará el botón Amortización siempre que la celda sea 
una celda válida; esto es, que contenga una cantidad, y la tabla visualizada sea la 
de pagos y no la de amortización. Añada este método a la clase Prestamo tal y 
como se muestra a continuación, y añada también la variable pagoMensual de tipo 
double atributo privado de la misma. 


private void tablaPrestamo_CellClick(object sender, 
DataGridViewCellEventArgs e) 
( 
if (ItablaPagos) return; 
try 
( 
pagoMensual = 
double.Parse(tablaPrestamo.CurrentCell.Value.ToString()); 
btCalculoAmort.Enabled = true; 
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catch (NullReferenceException) 


( 


) 


btCalculoAmort.Enabled = false; 
MessageBox.Show("La celda no contiene datos válidos"); 


Para visualizar la tabla de amortización a la que nos hemos referido anterior- 


mente, el usuario hará clic en el botón Amortización. Como respuesta, se ejecutará 
el método btCalculoAmort_ Click. Este método tiene como finalidad: 


Obtener el tipo de interés y la duración del préstamo correspondiente a la cel- 
da seleccionada. 


Crear la tabla con un número de filas igual al número de mensualidades a pa- 
gar y con un número de columnas igual a cuatro (no fijas). El valor mínimo 
de las filas de la tabla será siempre el valor del que partimos inicialmente. 


Mostrar en la columna cero los meses (1, 2, 3...) y en la fila cero las cabece- 
ras: Capital, Intereses, Capital pendiente y Total intereses. 


Calcular y mostrar los pagos mes a mes, hasta la finalización del período del 
préstamo, desglosados en capital amortizado e intereses pagados. Esto es, la 
tabla de amortización incluirá, por cada mensualidad, su desglose en capital e 
intereses, el capital pendiente después de realizar ese pago y el total de los in- 
tereses pagados hasta ese momento. 


Finalmente, inhabilitará de nuevo el botón Amortización y pondrá la variable 
tablaPagos a valor false. 


private void btCalculoAmort_Click(object sender, EventArgs e) 


( 


// Posición de la celda seleccionada 
Point pos = tablaPrestamo.CurrentCellAddress; 
// Obtener el tipo de interés correspondiente a la celda seleccionada 


string sinteres = 


tablaPrestamo.Rows[pos.Y].HeaderCe11.Value.ToString(); 





sinteres = sinteres.Substring(0, sinteres.Index0f(*%”)); 
double interes = double.Parse(sinteres) / 100 / 12; 

// Obtener el período correspondiente a la celda seleccionada 
int P = 0; 

if (!PrestamoEnAños.Enabled) 











P = 12; // son años 


else 


P = 1; // son meses 


string smeses = tablaPrestamo.Columns[pos.X].HeaderText; 
smeses = smeses.Substring(0, smeses.Index0f(” ?)); 
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int meses = int.Parse(smeses) * P; 
int filas = meses; 
int cols = 4; 
if (filas < 18) filas = 18; 
// Crear de nuevo la tabla 
tablaPrestamo.Columns.Clear(); 
niciarTabla(filas, cols); 
// Almacenar/mostrar en la columna fija los meses 
for (int mes = 0; mes <= meses - 1; mes++) 
tablaPrestamo.Rows[mes].HeaderCell.Value = 
string.Format("(0,5:D)", mes + 1); 
// Almacenar en la fila fija las distintas cabeceras 
string[] cab = new string[l] { "Capital", "Intereses", 
"Capital pendiente", "Total intereses" }; 
for (int col = 0; col <= 3; col++) 
tablaPrestamo.Columns[co1].HeaderText = cab[col]; 
// Calcular y mostrar la tabla de amortización. 
// La columna O de la tabla préstamo contiene el capital 
// pendiente y la 1 contiene el interés mensual a pagar 
double interesesMensuales = 0; 
double creditoPendiente = credito; 
double capitalMensualAmort = 0; 
double totallntereses = 0; 
for (int mes = 0; mes <= meses - 1; mes++) 
( 
// Cálculo del interés a pagar en el mes actual 
interesesMensuales = creditoPendiente * interes; 
// Cálculo del capital en el mes actual 
capitalMensualAmort = pagoMensual - interesesMensuales; 
// Cálculo del capital pendiente de pagar 
creditoPendiente -= pagoMensual - interesesMensuales; 
// Cálculo de los intereses totales pagados 
totallntereses += interesesMensuales; 
// Capital mensual amortizado 
tablaPrestamo.Rows[mes].Cel1s[0].Value = 
string.Format("(0,14:N2)", capitalMensualAmort); 
// Intereses mensuales amortizados 
tablaPrestamo.Rows[mes].Cel1s[1].Value = 
string.Format("(0,14:N2)", interesesMensuales); 
// Capital pendiente después de este pago 
tablaPrestamo.Rows[mes].Cells[2].Value = 
string.Format("(0,14:N2)", creditoPendiente); 
// Total intereses abonados después de este pago 
tablaPrestamo.Rows[mes].Cel1s[3].Value = 
string.Format("(0,14:N2)", totalIntereses); 
) 
btCalculoAmort.Enabled = false; 








290 ENCICLOPEDIA DE MICROSOFT VISUAL C# 


1 
$ 


tablaPagos = false; 


Finalmente, vamos a implementar la orden Acerca de..., del menú Ayuda. Es- 


ta orden visualizará una ventana que presentará los créditos de la aplicación. 





a y Aplicación Préstamo. Versión 1.0, 


W Copyright (c) Fco. Javier Ceballos, 2010 








Para ello, añada a la clase Prestamo, un controlador de eventos Click que res- 


ponda a la acción “clic” realizada sobre la orden “Acerca de...”: 


private void AyudaAcercaDe_Click (System.Object sender, Sys- 
tem.EventArgs e) 


( 


string mensaje; 

string NL = Environment.NewLine; 

mensaje = "Aplicación Préstamo. Versión 1.0." + NL; 

mensaje += "Copyright (c) Fco. Javier Ceballos, 2010"; 

MessageBox.Show(mensaje, "Acerca de Préstamo", 
MessageBoxButtons.0K, MessageBoxlIcon.Information); 


EJERCICIOS PROPUESTOS 


1. Modificar la aplicación ListView para que, partiendo de un árbol vacío, permita: 


a) 
b) 
c) 


a) 


b) 


Mostrar en la vista solo los nodos hijos del nodo seleccionado. 
Ver el contenido de un elemento al hacer doble clic sobre él en la vista. 


Mostrar un menú que permita guardar los datos del árbol en un fichero y ele- 
gir el fichero de datos para iniciar el árbol (seriar/deseriar un árbol). 


Modificar la aplicación Préstamo bancario para que: 


El texto de las cajas de texto que muestra la ventana marco quede selecciona- 
do cuando reciban el foco, bien mediante el teclado o al hacer clic con el ra- 
tón, lo que facilitará su modificación. 


Las cajas de texto que muestra la ventana marco solo admitan digitos del 0 al 
9, la coma decimal, los signos + y —, las teclas de retroceso y Entrar. 


CAPÍTULO 8 


O F.J.Ceballos/RA-MA 


DIBUJAR Y PINTAR 


Para pintar los gráficos (Incluyendo texto), así como para mostrar los elementos 
que componen una interfaz de usuario, Windows utiliza la interfaz de dispositivos 
gráficos (GDI+, Graphics Device Interface), la cual se encarga de llamar a las ru- 
tinas de los distintos gestores de dispositivo (drivers de vídeo, de impresora y de 
trazadores gráficos) que son los que directamente actúan sobre el dispositivo. Di- 
cho de otra forma, la interfaz de dispositivos gráficos es el medio que Windows 
proporciona para dibujar sobre dispositivos gráficos. 


Aplicación 1 Aplicación 2 


























Drivers de 
dispositivo 


Drivers de 
dispositivo 


Drivers de 
dispositivo 
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Puesto que existen muchos dispositivos gráficos de salida diferentes soporta- 
dos por Windows, uno de los objetivos principales de la GDI+ es permitir mostrar 
los gráficos independientemente del dispositivo utilizado. De esta forma podemos 
escribir aplicaciones que se ejecuten independientemente de las características 
particulares del dispositivo gráfico de salida que utilice una determinada máquina. 


Los dispositivos gráficos se pueden agrupar en dispositivos matriciales (dis- 
positivos raster) y dispositivos vectoriales. Los dispositivos matriciales represen- 
tan los gráficos como una matriz de puntos; pertenecen a este grupo los 
adaptadores de vídeo y las impresoras (matriciales y láser). En cambio, los dispo- 
sitivos vectoriales, como los trazadores gráficos o plotters, representan los gráfi- 
cos utilizando líneas. Como gran parte de la programación gráfica tradicional está 
basada exclusivamente en vectores, pero los dispositivos de salida gráficos en su 
mayoría utilizan puntos (píxeles) para mostrar los gráficos, la GDI+ ha sido escri- 
ta para ser utilizada como un sistema vectorial de dibujo de alto nivel y también 
para manipular puntos, sistema de bajo nivel. Esto está ligado a la facilidad de 
Windows de permitir utilizar un sistema de coordenadas virtual, manteniendo a la 
aplicación alejada del hardware, o utilizar el sistema de coordenadas del dispositi- 
vo, acercando la aplicación más al hardware. 


Otro tema a tener en cuenta es la resolución gráfica de los dispositivos y su 
capacidad de color. Para que una aplicación se ajuste a diferentes adaptadores de 
vídeo con diferentes resoluciones, el lenguaje gráfico tiene que proporcionar he- 
rramientas para poder determinar las características del hardware, lo que nos per- 
mitirá realizar los ajustes necesarios. Por otra parte, la GDI+ se ha construido para 
que el usuario no tenga que preocuparse excesivamente de los colores, realizando 
ella la mayoría de las conversiones según la capacidad de color del dispositivo. 


Cuando el dispositivo sobre el que se muestra la información es la pantalla, 
Windows utiliza el área de cliente de una ventana de la aplicación para dibujar 
(Windows solo puede mostrar información en el área de cliente de una ventana). 
Para informar sobre la necesidad de realizar una operación de dibujo, la ventana 
generará un evento Paint, lo que provocará que se ejecute el controlador que esté 
asociado con dicho evento. Esto ocurre automáticamente en los siguientes casos: 


e Cuando el tamaño de una ventana se modifica. 
e Cuando un área de una ventana cubierta por otra ventana se descubre porque 
se mueve o se cierra esta última. El área descubierta puede también proceder 


de un menú que se cierra o de un icono que se arrastra sobre dicha área. 


e Cuando se realiza un desplazamiento de lo visualizado por la ventana (la ven- 
tana tiene barras de desplazamiento). 
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e Cuando, utilizando el método adecuado, se invalida toda o parte del área de 
cliente de una ventana. 


En la mayoría de los casos en los que parte de una ventana es cubierta por 
otro elemento, es Windows el que guarda en algún lugar en la memoria la infor- 
mación necesaria para repintar dicha ventana. Cuando esto no suceda así, habrá 
que escribir el código necesario para que en respuesta al evento Paint pueda re- 
pintarse el área descubierta. 


La parte de la ventana que se repinta (generalmente un rectángulo) se deno- 
mina “región no válida”. Para automatizar el proceso de repintado Windows man- 
tiene internamente una “estructura de información de dibujo” para cada ventana. 
Entre esta información se encuentran las coordenadas del rectángulo que define la 
región no válida. También, cuando sea preciso, desde el código se puede declarar 
no válida una región para que se repinte (método Invalidate). 


Cuando hablamos de pintar o de repintar una región nos referimos a mostrar 
en esa región la información que en cada caso se requiera, sin importar si es texto, 
un dibujo lineal o un mapa de bits. Para cada caso, la GDI+ proporciona las clases 
adecuadas. 


SERVICIOS DE GDI+ 


Los servicios de GDI+ se engloban en tres amplias categorías: gráficos vectoriales 
2D, imágenes y tipografía. 


Los gráficos vectoriales están relacionados con el dibujo de tipos primitivos 
(como líneas, curvas y figuras) que se especifican mediante conjuntos de puntos 
en un sistema de coordenadas. Por ejemplo, una línea recta puede especificarse 
mediante dos puntos: los que definen sus extremos, y un rectángulo puede especi- 
ficarse mediante un punto que indique la ubicación de su esquina superior iz- 
quierda y un par de valores que indiquen el ancho y el alto. Un trazado simple 
puede especificarse mediante la matriz de puntos que se conectarán empleando lí- 
neas rectas para formar dicho trazado. Una línea flexible (spline) es una curva so- 
fisticada, especificada por cuatro puntos de control. 


Para realizar estos gráficos vectoriales, GDI+ proporciona clases y estructuras 
que realmente realizan el dibujo. Por ejemplo, la estructura Rectangle almacena 
la ubicación y el tamaño de un rectángulo; la clase Pen almacena información so- 
bre el color, ancho y estilo de línea; la clase Brush almacena información sobre el 
color de fondo; y la clase Graphics proporciona los métodos para dibujar líneas, 
rectángulos, trazados y otras figuras. 
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Una imagen vectorial se puede registrar en un metarchivo como una secuen- 
cia de órdenes gráficas. Para ello, la GDI+ proporciona las clases Metafile, Meta- 
file Header y MetaHeader. 


Por otra parte, imágenes como las mostradas por los botones de una barra de 
herramientas, iconos, o bien una fotografía digital, son tipos de imágenes que, de- 
pendiendo de los casos, son muy difíciles de mostrar con las técnicas de gráficos 
vectoriales, o, simplemente, que no se pueden mostrar mediante esta técnica. Por 
eso, este tipo de imágenes se almacenan como mapas de bits (matrices de núme- 
ros que representan los colores de puntos individuales de la pantalla). GDI+ pro- 
porciona la clase Bitmap para mostrar, manipular y guardar mapas de bits. 


Finalmente, la tipografía se ocupa de la presentación de texto en diversas 
fuentes, tamaños y estilos. Por ejemplo, una de las nuevas características de GDI+ 
es la función de alisado subpíxel que proporciona una apariencia más regular al 
texto que se muestra en una pantalla. 


Todos los servicios de GDI+ son suministrados por un amplio conjunto de 
clases, estructuras y enumeraciones agrupadas en los siguientes espacios de nom- 
bres: 


e System.Drawing. Proporciona acceso a los métodos gráficos básicos de 
GDI+. 


e System.Drawing.Drawing2D. Proporciona métodos gráficos vectoriales y 
bidimensionales avanzados. Por ejemplo, incluye los pinceles degradados, la 
clase Matrix utilizada para definir transformaciones geométricas, y la clase 
GraphicsPath que permite conectar series de líneas y curvas. 


e System.Drawing.Imaging. Proporciona métodos para manipular imágenes 
avanzadas. 


e System.Drawing.Text. Proporciona métodos para manipular la presentación 
del texto. 


e System.Drawing.Printing. Proporciona servicios relacionados con la impre- 
sión. 


OBJETOS DE DIBUJO BÁSICOS 


La clase Graphics es la base de la funcionalidad proporcionada por la GDI+; esto 
es, es la clase que realmente dibuja líneas, curvas, figuras, imágenes y texto. 


Antes de empezar a dibujar, debe elegir la superficie en la que quiere dibujar, 
el tipo de formas que desea dibujar y los instrumentos que utilizará para dibujar. 
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La superficie estará representada por un objeto Graphics, y sus métodos permiti- 
rán dibujar todas las formas básicas. Después, elegiremos los instrumentos Pen 
(lápiz o pluma), para dibujar las formas, y Brush (brocha o pincel), para rellenar 
esas formas; seleccionaremos una brocha solo cuando deseemos cambiar el color 
de fondo. Por último, dibujaremos la forma llamando al método adecuado del ob- 
jeto Graphics. Por ejemplo, el siguiente código dibuja una línea azul: 


Graphics g = this.CreateGraphics(); 
Pen lápizAzul = new Pen(Color.Blue); 
Point puntoA = new Point(10, 10); 
Point puntoB = new Point(200, 100); 
g.DrawLine(lápizAzul, puntoA, puntoB); 


La primera sentencia elige la superficie correspondiente al objeto this para 
dibujar. La sentencia siguiente crea un lápiz azul. Las dos sentencias siguientes 
definen los extremos de la línea a dibujar; las coordenadas están expresadas en pí- 
xeles. Y la última sentencia dibuja una línea llamando al método DrawLine; este 
método acepta como primer parámetro el instrumento con el que se dibujará, y 
como siguientes parámetros los puntos que definen la línea a dibujar. Este méto- 
do, como la mayoría de los métodos de Graphics, presenta múltiples formas; por 
ejemplo, puede omitir las definiciones del lápiz y de los puntos y especificar co- 
mo primer parámetro un lápiz de la clase Pens y como siguientes parámetros las 
coordenadas de los puntos que definen los extremos de las líneas: 


Graphics g = this.CreateGraphics(); 
g.DrawLine(Pens.Blue, 10, 10, 200, 100); 


Todas las coordenadas se expresan por defecto en píxeles, aunque, como ve- 
remos más adelante, es posible especificar las coordenadas en otras unidades, de- 
pendiendo de lo que estemos dibujando, y dejar que la GDI+ las convierta en 
píxeles antes de dibujar. El sistema de coordenadas predeterminado tiene el origen 
en la esquina superior izquierda de la superficie de dibujo, con el eje X apuntando 
hacia la derecha y el eje Y apuntando hacia abajo: 


(0, 0) X 





(2007 100) 
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Objeto Graphics 


El objeto Graphics es la superficie de dibujo. Cada control sobre el que se pueda 
dibujar expone su superficie a través de un objeto Graphics. 


Para recuperar el objeto Graphics de un objeto hay que invocar al método 
CreateGraphics de ese objeto (en la mayoría de los casos referenciado por this): 


Graphics g = this.CreateGraphics(); 


La sentencia anterior requerirá importar el espacio de nombres: 


using System.Drawing; 


Una vez realizadas las operaciones anteriores, la aplicación podrá dibujar so- 
bre la superficie representada por el objeto Graphics. Por ejemplo: 


private void btDibujar_Click(object sender, EventArgs e) 
( 

Graphics g = CreateGraphics(); 

g.DrawLine(Pens.Blue, 10, 10, 200, 100); 
) 


El método anterior se corresponde con el controlador del evento Click del bo- 
tón de pulsación btDibujar. La primera sentencia recupera el objeto Graphics que 
representa la superficie de dibujo correspondiente al área de cliente de una venta- 
na Forml, la que contiene el botón, y la segunda sentencia dibuja una línea azul 
definida por los puntos (10, 10) y 200, 100). 


El método apropiado para iniciar el objeto Graphics e insertar el código de 
dibujo es el controlador del evento Paint del objeto al que corresponde la superfi- 
cie de dibujo, ya que este evento es generado por un objeto cada vez que necesita 
repintarse. Por ejemplo: 


private void PictureBox1_Paint(object sender, PaintEventArgs e) 
( 

Graphics g = e.Graphics; 

g.DrawLine(Pens.Blue, 10, 10, 200, 100); 


El método anterior se corresponde con el controlador del evento Paint de un 
control PictureBox. La primera sentencia recupera el objeto Graphics que repre- 
senta la superficie de dibujo correspondiente al control PictureBox] y la segunda 
dibuja sobre esa superficie una línea azul definida por los puntos (10, 10) y 
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(200, 100). A diferencia del ejemplo anterior, ahora el objeto Graphics se obtiene 
a través del argumento e del controlador del evento Paint. 


Algunas de las propiedades que proporciona la clase Graphics son DpiX y 
DpiY, que especifican la resolución horizontal y vertical en píxeles por pulgada 
(una pulgada equivale a 25,4 milímetros) de la superficie de dibujo; PageUnit, 
que especifica la unidad empleada en el sistema de coordenadas; TextRende- 
ringHint, que especifica si se procesará el texto con la técnica de alisado; 
SmoothingMode es análoga a la anterior pero aplicable a todas las formas, y no 
solo al texto. 


La unidad de medida especificada por la propiedad PageUnit viene definida 
por los miembros de la enumeración GraphicsUnit especificados a continuación: 


e Display: unidad por omisión para el dispositivo de visualización; píxeles para 
la pantalla y 1/100 pulgadas para la impresora. 

Document: 1/300 pulgadas. 

Inch: una pulgada. 

Millimeter: un milímetro. 

Píxel: un píxel. 

Point: 1/72 pulgadas. 

World: unidad universal. 


La clase Graphics también proporciona los siguientes métodos que explica- 
remos a continuación: DrawLine, DrawRectangle, DrawEllipse, DrawPolygon, 
DrawArc, DrawCurve (para curvas flexibles cardinales), DrawBezier (para cur- 
vas flexibles de Bézier) y DrawString. Cada uno de estos métodos presenta múl- 
tiples formas; sirva como ejemplo el método DrawLine empleado en las 
explicaciones anteriores. 


Objeto Color 


El objeto Color del espacio de nombres System.Drawing representa un color. 
Por ejemplo: 


public partial class Forml : Form 

( 
private Color color ondo; 
private Color colorPrimerPlano; 


private void Forml_lLoad(object sender, EventArgs e) 


( 





colorfondo = Color.White; 
colorPrimerPlano = Color.Black:; 
PictureBox1.BackColor = colorFondo; 
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) 
2! 


private void PictureBox1_Paint(object sender, PaintEventArgs e) 
( 
1! 
) 
) 


El ejemplo anterior define un color para el fondo de un objeto y otro para el 
primer plano, como atributos de la clase Form]. Después, inicia ambas variables 
en el controlador del evento Load del formulario con los colores blanco y negro, 
respectivamente. Finalmente, en el mismo controlador, establece el color de fondo 
del control PictureBox1 (propiedad BackColor). 


La estructura Color dispone de 128 atributos para definir toda una colección 
de colores para elegir. 


Objeto Pen 


Todos los métodos de dibujo de la clase Graphics operan junto con un objeto 
Pen; esto es, para dibujar cualquier forma, deben crearse como mínimo un objeto 
Graphics para definir la superficie de dibujo y un objeto Pen que defina el color 
y el ancho de línea del elemento que se va a dibujar. Por ejemplo: 


private void PictureBox1_Paint(object sender, PaintEventArgs e) 
( 

Pen lápizNegroN3 = new Pen(colorPrimerPlano, 3); 

Graphics g = e.Graphics; 

g.DrawEllipse(lápizNegroN3, 10, 10, 200, 100); 
) 


Este ejemplo define un lápiz, lápizNegroN3, de color negro y de ancho tres 
píxeles que posteriormente es utilizado por el método DrawEllipse para dibujar 
una elipse. Si se omite el segundo argumento del constructor Pen, se creará por 
omisión un lápiz con una anchura de un solo píxel. 


En los ejemplos iniciales vimos que también existe una clase Pens que pro- 
porciona lápices de ancho un píxel para todos los colores estándar. Por ejemplo, la 
siguiente sentencia proporciona un lápiz negro de un píxel de ancho: 


Pens.Black; 
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Objeto Brush 


Cuando se dibuja una forma, por ejemplo un rectángulo o una elipse, se rellena 
con el color de fondo actualmente establecido. Para rellenarla con otro color sóli- 
do, con un patrón o con un mapa de bits hay que crear una brocha o pincel (objeto 
Brush) y aplicarlo a la forma invocando al método adecuado. Por ejemplo: 


SolidBrush brochaSólidaVerdeMar = 

new SolidBrush(Color.LightSeaGreen); 
Pen lápizNegroN3 = new Pen(colorPrimerPlano, 3); 
Graphics g = e.Graphics; 
g.DrawEllipse(lápizNegroN3, 10, 10, 200, 100); 
g.F111Ellipse(brochaSólidaVerdeMar, 10, 10, 200, 100); 


Este ejemplo dibuja una elipse y pinta todo su interior con la brocha bro- 
chaSólidaVerdeMar especificada. Obsérvese que la brocha es un objeto de la cla- 
se SolidBrush. Esto es así porque Brush es una clase abstracta de la que se 
derivan los distintos tipos de brochas que podemos utilizar y que indicamos a con- 
tinuación: 


e Brocha sólida. Objeto de la clase SolidBrush. Utiliza un color sólido para re- 
llenar el interior de una forma. 


e Brocha rayada. Objeto de la clase HatchBrush. Utiliza un rayado para relle- 
nar el interior de una forma (líneas verticales, horizontales, en diagonal, etc.). 


e Brocha degradada. Objeto de la clase LinearGradientBrush (degradado li- 
neal) o de la clase PathGradientBrush (degradado de color). Utiliza colores 
que se irán degradando mientras se rellena el interior de una forma. 


e Brocha textura. Objeto de la clase TextureBrush. Utiliza una imagen para re- 
llenar el interior de una forma. 


El siguiente ejemplo dibuja una elipse y pinta todo su interior con una brocha 
que define un degradado horizontal que cambia de azul a azul claro conforme se 
avanza del borde izquierdo de la elipse al borde derecho: 


Rectangle rect = new Rectangle(10, 10, 200, 100); 
Graphics g = e.Graphics; 


LinearGradientBrush brochaDregradada = 
new LinearGradientBrushí(rect, Color.Blue, Color.AliceBlue, 
LinearGradientMode.Horizontal):; 
g.Fi11Ellipse(brochaDregradada, rect); 
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Objeto Point 


Un objeto Point representa un punto en la superficie de dibujo y se expresa como 
un par de coordenadas (x, y). La coordenada x es la distancia horizontal desde el 
origen (0, 0) y la coordenada y es la distancia vertical desde el origen. Por ejem- 
plo, el siguiente código dibuja una línea definida por los puntos A y B: 


Graphics g = e.Graphics; 

Point A = new Point(10, 10); 
Point B = new Point(200, 100); 
g.DrawLine(Pens.Blue, A, B); 


Alternativamente, puede declarar un objeto Point y después asignar a sus 
propiedades X e Y los valores correspondientes. 


Dependiendo de las unidades en las que haya definido el sistema de coorde- 
nadas que esté utilizando, puede suceder que necesite expresar las coordenadas no 
como un valor entero, sino como un valor fraccionario; en este caso utilice objetos 
de tipo PointF que definen sus atributos X e Y de tipo float. 


Objeto Rectangle 


Un objeto Rectangle almacena cuatro enteros que representan la posición y tama- 
ño de un rectángulo. Por ejemplo, el siguiente código dibuja la elipse que está ins- 
crita en el rectángulo rect utilizando la técnica de alisado: 


Pen lápizNegroN3 = new PenícolorPrimerPlano, 3); 
Graphics g = e.Graphics; 

g.SmoothingMode = SmoothingMode.HighQuality; 
Rectangle rect = new Rectangle(10, 10, 200, 100); 
g.DrawEllipse(lápizNegroN3, rect); 


Los dos primeros enteros de Rectangle indican la posición de la esquina su- 
perior izquierda del rectángulo y los dos siguientes se corresponden con la anchu- 
ra y la altura, respectivamente, del rectángulo. 


Una alternativa a la definición anterior del objeto Rectangle es la siguiente: 


Point p = new Point(10, 10); 
Size dims = new Size(200, 100); 
Rectangle rect = new Rectangle(p, dims); 


En este ejemplo, el objeto Rectangle se define a partir de un objeto Point, 
que define la esquina superior del rectángulo, y de un objeto Size, que define las 
dimensiones del rectángulo. 
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Alternativamente, puede declarar un objeto Size y después asignar a sus pro- 
piedades Width y Height los valores correspondientes. 


Objeto Font 


Un objeto Font define un formato concreto para el texto, incluidos el nombre de 
la fuente, el tamaño y el estilo. Para especificar una fuente, cree un objeto Font, 
fije el nombre de la familia, el tamaño y el estilo, y aplíquela cuando pinte el tex- 
to, por ejemplo, invocando al método DrawString. El constructor Font tiene mu- 
chas formas; las más sencillas permiten crear el objeto Font con el nombre de la 
familia y el tamaño, o bien con el nombre de la familia, el tamaño y el estilo. Por 
ejemplo: 


private void btDibujar_Click(object sender, EventArgs e) 
( 
Graphics g = PictureBox1.CreateGraphics(); 
Font fuente = new Font("Arial", 16); 
g.DrawString("Texto a mostrar", fuente, Brushes.Blue, 10, 10); 


} 


El método anterior se corresponde con el controlador del evento Click del bo- 
tón de pulsación btDibujar. La primera sentencia recupera el objeto Graphics que 
representa la superficie de dibujo correspondiente al control PictureBoxl, la se- 
gunda crea un objeto Font que define la fuente “Arial” de tamaño 16 y la tercera 
dibuja la cadena de caracteres “Texto a mostrar” en la superficie gráfica a partir 
de la posición (10, 10) en color azul. 


Evidentemente, una fuente puede crearse a partir de otra existente. Se puede 
crear un duplicado invocando al método Clone, o simplemente una nueva refe- 
rencia (sin utilizar Clone). Por ejemplo: 


Font fuenteActual = (Font)Font.Clone(); 


Las propiedades FontFamily, Size, Style, etc., son de solo lectura, lo que no 
permite alterar una fuente ya creada. Para salvar este inconveniente, puede crear 
una fuente nueva basada en los valores de otra existente. Por ejemplo: 


Font fuenteNueva = new Font(fuenteActual.FontFamily, 
fuenteActual.Size + 4, 
fuenteActual.Style | FontStyle.Bold); 


La fuente nueva pertenece a la misma familia de la actual, su tamaño se ha in- 
crementado en cuatro unidades y tiene el mismo estilo más negrita (Bold). 
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Objeto GraphicsPath 


El objeto GraphicsPath, denominado también trazado, representa una serie de 
figuras conectadas entre sí (véase el apartado Trazados un poco más adelante). 


MÉTODOS DE DIBUJO 


Una vez que se han expuesto los objetos básicos, vamos a centrarnos en los méto- 
dos de dibujo, algunos de los cuales ya han sido utilizados en los ejemplos ante- 
riores. 


Todos los métodos de dibujo tienen en común que su primer parámetro es un 
objeto Pen, y los siguientes parámetros definen la forma a dibujar. Por otra parte, 
los podemos agrupar en dos categorías: los que dibujan formas sin rellenar y los 
que dibujan formas rellenas; el nombre de los primeros empieza por Draw..., y el 
de los segundos, por Fill... Estos últimos, a diferencia de los primeros, tienen co- 
mo primer parámetro un objeto Brush que define el color con el que será rellena- 
da la forma dibujada. 


Líneas y rectángulos 


Para dibujar una línea, hay que llamar al método DrawLine del objeto Graphics. 
Por ejemplo, el código siguiente dibuja la línea definida por los puntos (10, 10) y 
(240, 100) en la superficie g: 


Graphics g = PictureBox1.CreateGraphics(); 
Pen lápiz = new Pen(Color.Black, 3); 
g.DrawLine(lápiz, 10, 10, 240, 100); 


Existen varias formas del método DrawLine y, además, el objeto Pen tam- 
bién expone propiedades, como DashStyle, que pueden utilizarse para especificar 
características de la línea. Por ejemplo, el siguiente código dibuja una línea dis- 
continua: 


lápiz.DashStyle = DashStyle.Dash; 
Point puntoA = new Point(10, 10); 
Point puntoB = new Point(240, 100); 
g.DrawLine(lápiz, puntoA, puntoB); 


Dibujar rectángulos es parecido a dibujar líneas. Ahora el método utilizado es 
DrawRectangle, del que también existen múltiples formas. A continuación se 
pueden observar dos formas diferentes de dibujar un mismo rectángulo: 
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g.DrawRectangle(lápiz, 50, 80, 200, 100); 


Rectangle rect = new Rectangle(50, 80, 200, 100); 
g.DrawRectangle(lápiz, rect); 


También es posible recopilar información sobre el rectángulo a través de las 
propiedades y métodos de Rectangle. Por ejemplo, los métodos Inflate y Offset 
permiten cambiar el tamaño y la posición del rectángulo, el método Intersects- 
With permite saber si el rectángulo forma una intersección con otro rectángulo 
determinado, y Contains indica si un punto determinado se encuentra dentro del 
rectángulo. 


Elipses y arcos 


Una elipse se define mediante el rectángulo en el que está inscrita. En la siguiente 
figura se muestra una elipse junto con su rectángulo delimitador. 








Para dibujar una elipse, utilizaremos el método DrawEllipse. El primer ar- 
gumento será el objeto Pen y el resto de los argumentos que se pasan especifican 
el rectángulo delimitador de la elipse. Por ejemplo, la siguiente sentencia dibuja 
una elipse; el rectángulo delimitador tiene un ancho de 230, un alto de 90 y su es- 
quina superior izquierda coincide con el punto (10, 10): 


g.DrawEllipse(lápiz, 10, 10, 230, 90); 


DraweEllipse es un método sobrecargado de la clase Graphics, lo cual quiere 
decir que existen varias formas de proporcionar argumentos a dicho método. Por 
ejemplo, se puede construir un objeto Rectangle y pasarlo como segundo argu- 
mento: 


Rectangle rect = new Rectangle(10, 120, 230, 90); 
g.DrawEllipse(lápiz, rect); 
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Un arco es una parte de una elipse. Para dibujar un arco, utilizaremos el mé- 
todo DrawArc de la clase Graphics. Los parámetros del método DrawArc son 
los mismos que los del método DrawEllipse, más un ángulo inicial y un ángulo 
de barrido. En el siguiente ejemplo se dibuja un arco con un ángulo inicial de 30 
grados y un ángulo de barrido de 180 grados: 


g.DrawArc(lápiz, rect, 30, 180); 


El código completo que da lugar a las formas mostradas en la figura anterior 
es el siguiente: 


private void btElipsesArcos_Click(object sender, EventArgs e) 
( 

Graphics g = PictureBox1.CreateGraphics(); 

Pen lápiz = new Pen(Color.Black); 

lápiz.DashStyle = System.Drawing.Drawing2D.DashStyle.Dot; 
g.DrawRectangle(lápiz, 10, 10, 230, 90); 
lápiz = new Pen(Color.Black, 3); 
g.DrawEllipse(lápiz, 10, 10, 230, 90); 


Re 
lápi 
lápiz.DashStyle = System.Drawing.Drawing2D.DashStyle.Dot; 


ctangle rect = new Rectangle(10, 120, 230, 90); 
p 
p 
g.DrawEllipse(lápiz, rect); 
p 
D 


iz = new Pen(Color.Black, 3); 





lápiz = new Pen(Color.Red, 3); 
g.DrawArc(lápiz, rect, 30, 180); 





Tartas 


Un gráfico de tarta es una forma parecida a una tarta; esto es, un arco junto con 
las dos líneas que unen sus vértices en el centro de la elipse a la que pertenece el 
arco. Para dibujar este tipo de gráficos, el objeto Graphics proporciona el método 
DrawPie que tiene como parámetros los mismos que el método DrawArc. 


g.DrawPie(lápiz, rect, 30, 150); 


Polígonos 


Un polígono es una forma cerrada definida por tres o más puntos. Por ejemplo, un 
triángulo y un rectángulo son polígonos. 


Para dibujar un polígono, son necesarios un objeto Graphics que proporciona 
el método DrawPolygon, un objeto Pen y una matriz de objetos Point (o 
PointF). Esta matriz almacenará los puntos que se van a conectar mediante líneas 
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rectas. En el siguiente ejemplo se dibuja un polígono de cinco lados. Hay que co- 
locar los puntos en el orden en el que van a ser recorridos. El método 
DrawPolygon cierra el polígono de forma automática. 


PointF[] pentágono = [ 
new Point(20, 150), 
new Point(130, 120), 
new Point(230, 155), 
new Point(190, 200), 
new Point(45, 195) 
J; 
g.DrawPolygon(lápiz, pentágono); 





Curvas flexibles 


Distinguimos dos tipos de curvas flexibles: cardinales y de Bézier. Una curva fle- 
xible cardinal es una secuencia de curvas individuales combinadas para formar 
una curva mayor; se especifica mediante una matriz de puntos y un parámetro de 
tensión que por omisión vale 0,5, y se dibuja invocando a DrawCurve. Una curva 
flexible de Bézier se especifica con cuatro puntos: dos puntos correspondientes a 
los extremos (p1 y p2) y dos puntos de control (c17 y c2). La curva comienza en pl 
y acaba en p2. La curva no pasa por los puntos de control, pero estos se compor- 
tan como imanes, y tiran de la curva en ciertas direcciones e influyen en el modo 
en que la curva se dobla. Se dibuja invocando a DrawBezier. 


A continuación se muestra un ejemplo de dos curvas, una cardinal y otra de 
Bézier: 


// Puntos que definen la curva flexible cardinal 
Point[] puntos = { 

ew Point(25, 25), 

ew Point(50, 15), 

ew Point(100, 5), 

ew Point(120, 25), 

ew Point(150, 50), 

ew Point(220, 200), 

ew Point(120, 120) ); 

// Dibujar líneas entre los puntos 
g.DrawLines(lápizRojo, puntos); 

// Dibujar la curva 
g.DrawCurve(lápizVerde, puntos); 








// Puntos que definen la curva flexible de Bézier 
Point p1 = new Point(30, 120); 

Point p2 = new Point(150, 200); 

Point cl = new Point(75, 10); 

Point c2 = new Point(50, 210); 
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// Dibujar la curva 
g.DrawBezier(lápizNegro, pl, cl, c2, p2); 


Trazados 


Un trazado es un objeto de la clase GraphicsPath. Se trata de una figura formada 
por una secuencia de líneas, rectángulos, elipses, arcos, polígonos, curvas flexi- 
bles, etc., cuyos puntos inicial y final pueden o no ser coincidentes. 


La clase GraphicsPath proporciona varios métodos para la creación de una 
secuencia de elementos que se van a dibujar: AddLine, AddRectangle, Add- 
Ellipse, AddArc, AddPolygon, AddCurve y AddBezier. Cada uno de estos mé- 
todos admite varias formas. A continuación se muestra un ejemplo: 


Graphics g = PictureBox1.CreateGraphics(); 
GraphicsPath trazado = new GraphicsPath(); 
Rectangle rect = new Rectangle(10, 10, 200, 100); 
trazado.AddArcí(rect, 45, 135); 
trazado.Addline(80, 100, 160, 200); 
trazado.CloseFigure(); 

g.DrawPath(Pens.Blue, trazado); 





Un trazado es una figura abierta, a menos que se cierre de forma explícita in- 
vocando al método CloseFigure, que cierra la figura actual con una línea desde el 
punto final hasta el punto inicial. Una figura formada por una forma geométrica 
primitiva es una figura cerrada. 


Esta forma de trabajar puede ser interesante, por ejemplo, para dibujar varias 
veces el mismo trazado, con un lápiz distinto, o rellenar las formas que componen 
el trazado con el mismo degradado o mapa de bits, etc. 


Regiones 


Una región es una parte de la superficie de dibujo de un dispositivo de salida. Las 
regiones pueden ser simples (un único rectángulo) o complejas (una combinación 
de polígonos y curvas cerradas). Se utilizan a menudo para recortar, acción que 
implica restringir el dibujo a una determinada área de presentación (normalmente 
la parte que necesita una actualización), y para comprobar si se hizo clic con el ra- 
tón en una cierta región de la pantalla. 


Se puede construir una región a partir de un rectángulo o de un trazado. Tam- 
bién se pueden crear regiones complejas mediante la combinación de regiones 
existentes. La clase Region proporciona los siguientes métodos para combinar re- 
giones: Intersect, Union, Xor, Exclude y Complement. 
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La intersección de dos regiones, Intersect, es el conjunto de todos los puntos 
que pertenecen a ambas regiones. La unión, Union, es el conjunto de todos los 
puntos que pertenecen a una u otra región. El método Xor, aplicado a un par de 
regiones, genera una región que contiene todos los puntos que pertenecen a una 
región o a otra, pero no a ambas. El método Exclude, aplicado a un par de regio- 
nes, genera una región que contiene todos los puntos que pertenecen a la primera 
región y que no están en la segunda. El complemento, Complement, de una re- 
gión es el conjunto de todos los puntos que no están en la región. 


Para rellenar una región, son necesarios un objeto Graphics, que proporciona 
el método FillRegion, un objeto Brush y un objeto Region. Por ejemplo, la si- 
guiente sentencia rellena una región con un color sólido: 


g.FillRegioníbrocha, región); 


Como ejemplo vamos a escribir el controlador de un botón “Regiones” que 
muestre tres elipses solapadas como muestra la figura siguiente: 





Líneas y ... 
Blipses y ... 


Tartas 


Polígonos 


Curvas 
Trazados 


Limpiar 











El propósito es definir una región que restrinja el área de dibujo a los puntos 
que no sean comunes a dos o más elipses; esta región recibe el nombre de “región 
de recorte”. El dibujo que realizaremos sobre la región así definida consistirá en 
trazar radios desde el centro de la misma a intervalos de 2 grados. Obsérvese en la 
figura anterior cómo los radios quedan recortados en los límites de la región. Esto 
implica invocar al método SetClip del objeto Graphics para definir la región de 
recorte. Aplicaremos también una transformación que defina el eje Y positivo ha- 
cia arriba y traslade el origen (0, 0) al centro de la superficie de dibujo. Las trans- 
formaciones se explicarán con detalle en el apartado siguiente. 


private void btRegiones_Click(object sender, EventArgs e) 
( 

// Superficie de dibujo 

Graphics g = PictureBox1.CreateGraphics(); 
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// Lápiz 

Pen lápiz = new Pen(Color.Black, 3); 

// Centro de la superficie de dibujo 

int xCentro = PictureBox1.Width / 2; 

int yCentro = PictureBox1.Height / 2; 

// Transformaciones: eje Y positivo hacia arriba y 
// origen (0,0) en el centro 
g.Transform = new Matrix(1, 0, 0, -1, xCentro, yCentro); 
// Rectángulos para tres elipses 
Rectangle rect0 = new Rectangle(-50, 0, 100, 100); 
Rectangle rectl = new Rectangle(-7, -75, 100, 100); 
Rectangle rect2 = new Rectangle(-93, -75, 100, 100); 
// Añadimos tres elipses a un trazado 

GraphicsPath trazado = new GraphicsPath(); 
trazado.AddEllipse(rectO); 
trazado.AddEllipse(rectl):; 
trazado.AddEllipse(rect2):; 

// Pintar el trazado 
g.FillPath(Brushes.Yellow, trazado); 
// Crear una región con el trazado 
Region región = new Region(trazado); 




















// Definir la región de recorte: 

// región de recorte actual intersección objeto región 
g.SetClip(región, CombineMode.Intersect); 

// Dibujar radios desde el origen, de dos en dos grados 
float PI = 3.1415926F; 

float radio = Math.Min(xCentro, ylentro); 

float a; 

float x; 

float y; 

for la = 0; a <= 2 * Pl; a += Pl / 90) 

( 





x = System.Convert.ToSinglelradio * Math.Cos(a)):; 
y = System.Convert.ToSingle(radio * Math.Sin(a)):; 
g.DrawLine(Pens.Red, 0, 0, x, y); 





) 
) 


Para mayor facilidad en el desarrollo hemos definido un trazado. No obstante, 
podríamos haber definido cada elipse en un trazado y combinar los tres trazados 
(las tres elipses) directamente en una región, combinando las dos primeras y el re- 
sultado con la tercera: 


GraphicsPath trazado0 = new GraphicsPath(); 
trazado0.AddE11lipse(rectoO); 
GraphicsPath trazadol = new GraphicsPathn(); 
trazadol.AddEllipse(rectl); 
GraphicsPath trazado2 = new GraphicsPathn(); 
trazado2.AddE1lipse(rect2); 
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Region región = new Region(trazado0); 
región.Xor(trazadol); 
región.Xor(trazado2); 
g.FillRegion(Brushes.Yellow, región); 


GRÁFICOS PERSISTENTES 


En el apartado anterior, para explicar los distintos objetos y métodos gráficos, 
construimos una aplicación que visualizaba una ventana con varios botones, cada 
uno de los cuales mostraba una forma diferente. Pruebe a ejecutar la aplicación. 
Haga clic en un botón para mostrar un gráfico. Minimice la ventana y a continua- 
ción vuélvala a su posición normal. ¿Qué ha sucedido? Observará que el gráfico 
ya no se muestra. 


En un caso como el descrito, sabemos que la ventana produce el evento Paint 
para indicar la necesidad de repintarse. Pues bien, para que un gráfico realizado 
con métodos gráficos (imágenes y texto) pueda ser reproducido automáticamente 
cuando la ventana que lo muestra produzca un evento Paint, la aplicación debe 
ser capaz de reproducirlo por algún medio. De aquí el nombre de “gráficos persis- 
tentes”. Una ventana produce el evento Paint cuando: 


Se construye por primera vez. 

Se superpone encima de otra. 

Se minimiza y después se maximiza. 

Cambia de tamaño. 

El código de la aplicación lo genera invocando al método Invalidate. 


Según lo expuesto, para reproducir los gráficos, hay que incluir el código ne- 
cesario en el método que se ejecute en respuesta al evento Paint. Por ejemplo: 


private void PictureBox1_Paint(object sender, PaintEventArgs e) 
( 
// Superficie de dibujo 
Graphics g = e.Graphics; 


// Líneas y rectángulos 

Pen lápiz = new Pen(Color.Black, 3); 
g.DrawLine(lápiz, 10, 10, 240, 100); 

Rectangle rect = new Rectangle(10, 120, 230, 90); 
g.DrawRectangle(lápiz, rect); 


} 








Ahora, cada vez que el control PictureBox] produzca el evento Paint, se re- 
pintará ejecutando el método PictureBox1_ Paint. El código completo de la apli- 
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cación mencionada, pero ahora con gráficos persistentes, lo encontrará en la car- 
peta Cap08\Paint del CD que acompaña al libro. 


Esta técnica es buena para aplicaciones que presentan un gráfico en base a un 
código que se ejecuta como respuesta al evento Paint, pero no para aplicaciones 
que dibujen algo en respuesta a acciones del usuario; por ejemplo, piense en un 
panel de dibujo del estilo de la aplicación Paint de Windows; el usuario elige de 
una barra de herramientas la forma que quiere dibujar y, utilizando el ratón, dibuja 
esa forma sobre la superficie. En este caso, el controlador del evento Paint no 
puede prever lo que el usuario va a dibujar y, por otro lado, seguir la pista de lo 
dibujado para poder reproducirlo es una tarea un tanto complicada. La solución 
para un caso como este es crear una superficie de dibujo permanente y dibujar los 
gráficos sobre ella. 


Para crear una superficie de dibujo permanente, siga los pasos indicados a 
continuación: 


1. Cree un mapa de bits, objeto Bitmap, del mismo tamaño que la superficie de 
dibujo del control o del formulario. 


2. Asigne el mapa de bits a la propiedad Image del control o a la propiedad Ba- 
ckgroundImage del formulario. 


3. Cree la superficie de dibujo desde el mapa de bits. Esta superficie es perma- 
nente (método FromImage de Graphics). 


4. Opcionalmente, puede utilizar el método Clear de Graphics para establecer 
el color de fondo de la superficie de dibujo. 


La función ObtenerObjetoGraphics que se muestra a continuación devuelve 
una superficie de dibujo permanente: 


private Graphics ObtenerObjetoGraphics() 
( 
Bitmap mapaBits = 
new Bitmap(PictureBox1.Width, PictureBox1.Height); 
PictureBox1.Image = mapaBits; 
Graphics g = Graphics.Fromlmage(mapaBits):; 
return g; 


} 


El método siguiente utiliza la función anterior para dibujar gráficos persisten- 
tes: 


private void btLineasRect_Click(object sender, EventArgs e) 
( 
Graphics g = ObtenerObjetoGraphics(); 
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Pen lápiz = new Pení(Color.Black, 3); 
g.DrawLine(lápiz, 10, 10, 240, 100); 


Rectangle rect = new Rectangle(10, 120, 230, 90); 
g.DrawRectangle(lápiz, rect); 
) 


El código completo de la aplicación Formas, pero ahora utilizando una super- 
ficie de dibujo permanente, lo encontrará en la carpeta Cap0SFormasPermanen- 
tes del CD que acompaña al libro. 


SISTEMAS DE COORDENADAS Y TRANSFORMACIONES 


Después de lo estudiado hasta ahora, sabemos que todas las coordenadas se expre- 
san por defecto en píxeles, aunque, según se expuso anteriormente, es posible es- 
pecificar las coordenadas en otras unidades y dejar que la GDI+ las convierta en 
píxeles antes de dibujar. Por ejemplo, la sentencia siguiente dibuja la línea defini- 
da por los puntos (0, 0) y (100, 40) en la superficie g (representada en la figura si- 
guiente por el rectángulo de líneas punteadas) que de forma predeterminada 
define el origen (0, 0) en su esquina superior izquierda con el eje X apuntando ha- 
cia la derecha y el eje Y apuntando hacia abajo: 


g.DrawLine(Pens.Blue, 0, 0, 100, 40) 


(100, 40) 


Supongamos que deseamos trabajar con un sistema de coordenadas que tenga 
su origen en el centro de la superficie de dibujo en lugar de en la esquina superior 
izquierda. Calcular las coordenadas del centro de la superficie de dibujo es una ta- 
rea fácil. Por ejemplo, si la superficie de dibujo es la correspondiente a un control 
de la clase PictureBox, podríamos realizar este cálculo así: 


int xCentro = PictureBox1.Width / 2; 
int yCentro PictureBox1.Height / 2; 
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Ahora, si el punto (0, 0) se traslada al punto (xCentro, yCentro), al dibujar la 
recta sobre la superficie de dibujo todos sus puntos tendrán que sufrir la misma 
traslación; esto es, las coordenadas X de todos los puntos de la recta tendrán que 
ser incrementadas en xCentro y las coordenadas Y en yCentro. 


(0, 0) 





(100, 40) 


La operación de traslación recibe el nombre genérico de transformación y se 
aplicaría enviando a la superficie g el mensaje TranslateTransform: 


g.Translatelransformí(xCentro, yCentro); 


Básicamente, hay tres tipos de transformaciones: escalados, rotaciones y tras- 
laciones. Todas ellas se resuelven con operaciones con matrices. Las transforma- 
ciones lineales, como los escalados y las rotaciones, se resuelven con una 
multiplicación de matrices, y las no lineales, como las traslaciones, con una suma 
de matrices. 


Por ejemplo, si se considera un punto en un plano como una matriz 1x2, se 
puede transformar para realizar una traslación sumándole una matriz 1x2: 


(100 40) + (xCentro yCentro) = (100+xCentro 40+yCentro) 
También se puede transformar dicho punto para realizar un escalado multipli- 


cándolo por una matriz 2x2. Por ejemplo, escalar por 2 el punto (100, 40) en la di- 
rección del eje X y del eje Y, se haría así: 


(100 ol > (200 80) 


Aplicar una rotación de 90 grados al punto (100, 40) se haría así: 


CAPÍTULO 8: DIBUJAR Y PINTAR 313 


(100 20)e o 100) 


Reflejar en el eje X el punto (100, 40) se haría así (equivale a hacer que el eje 
Y apunte hacia arriba): 


0 


(100 20), 5000 -40) 


Una transformación lineal (multiplicación por una matriz 2x2) seguida de una 
traslación (adición de una matriz 1x2) se denomina “transformación afín”: 


1 
(1 00 40)x E ° + (xCentro yCentro) = (1 00+xCentro —40+ yCentro) 


Una alternativa a una transformación afín es almacenar la transformación 
completa en una matriz 3x3. Para que esto funcione, hay que almacenar un punto 
del plano en una matriz 1x3 con una tercera coordenada ficticia. La técnica más 
habitual es hacer que todas las terceras coordenadas sean iguales a 1. Por ejemplo, 
el punto (100, 40) viene representado por la matriz (100 40 1). Según lo expuesto, 
una alternativa a la transformación afín anterior (reflejar en el eje X más trasla- 
ción) expresada como multiplicación por una única matriz 3x3 es la siguiente: 


1 0 0 
(100 40 1)x| 0 -1 0|=(100+xCentro -40+ yCentro 1) 
xCentro yCentro 1 


En este ejemplo, el resultado es que el punto (100, 40) se asigna al punto 
(100+xCentro, —40+yCentro). Tenga en cuenta que la tercera columna de la ma- 
triz 3x3 contiene los números 0, 0, 1. Esto siempre será así para el caso de la ma- 
triz 3x3 de una transformación afín. Los números importantes son los seis 
números de las columnas 1 y 2. La parte superior izquierda 2x2 de la matriz re- 
presenta la parte lineal de la transformación, y las dos primeras entradas de la ter- 
cera fila representan la traslación. 


En GDHIH, es posible almacenar una transformación afín en un objeto Matrix. 
Cuando se construye un objeto Matrix, solo se especifican los seis números de las 
dos primeras columnas, ya que la tercera columna de una matriz que representa 
una transformación afín siempre es (0, 0, 1). Según esto, la sentencia siguiente 
construye la matriz que se muestra en el ejemplo anterior: 
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g.Transform = new Matrix(1, 0, 0, -1, xCentro, yCentro); 


La clase Matrix proporciona varios métodos para generar una transformación 
compuesta: Multiply, Rotate, RotateAt, Scale, Shear y Translate. En el si- 
guiente ejemplo se crea la matriz de una transformación compuesta que, primero, 
rota 30 grados, después ajusta la escala en un factor de 4 en la dirección del eje X 
y en un factor de 8 en la dirección del eje Y, y finalmente se traslada xCentro uni- 
dades en la dirección del eje X e yCentro unidades en la dirección del eje Y: 


Graphics g = PictureBox1.CreateGraphics(); 
int xCentro = PictureBox1.Width / 2; 

int yCentro = PictureBox1.Height / 2; 
Matrix matriz = new Matrix(); 

// Transformación 

matriz.Rotate(30); 

matriz.Scale(4, 8, MatrixOrder.Append); 
matriz.Translate(xCentro, yCentro, MatrixOrder.Append); 
Ga PENSA = matriz; 

// Dibujar 

GraphicsPath tr = new GraphicsPath(); 
tr.AddLine(0, 0, 100, 40); 
g.DrawPath(Pens.Blue, tr); 





La matriz resultante de esta transformación es la siguiente: 


cos30° 2sen30° 0 
—sen30° 2cos30° 0 


xCentro yCentro 1l 


El orden en una transformación compuesta es importante. En general, un or- 
den de rotación, ajuste de escala y traslación no es lo mismo que un orden de ajus- 
te de escala, rotación y traslación. Análogamente, el orden de multiplicación de 
matrices es importante. En general, m] :m2:m3 no es lo mismo que m2:m1:m3. Por 
eso, los argumentos Append y Prepend (valor por omisión) tienen su importancia. 
Append indica que la nueva operación se aplica después de la operación antigua y 
Prepend que la nueva operación se aplica antes de la operación antigua. Según es- 
to, la transformación del ejemplo anterior podría especificarse también así: 


matriz.Translate(xCentro, yCentro) 
matriz.Scale(4, 8) 
matriz.Rotate(30) 


En el ejemplo anterior se puede observar que la transformación se aplica a to- 
dos los elementos del objeto Graphics (superficie g), incluyendo el lápiz con el 
que se está dibujando, razón por la que se denomina “transformación global”. Ob- 
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sérvese que para crear una transformación global se crea un objeto Matrix que 
almacena la secuencia de transformaciones afines y se asigna a la propiedad 
Transform de la superficie de dibujo. En contraposición, una transformación lo- 
cal se aplica a un elemento específico que se va a dibujar. Por ejemplo, un objeto 
GraphicsPath tiene un método Transform con un parámetro de tipo Matrix que 
permite transformar los puntos de datos de ese trazado. 


// Transformación 

matriz.Rotate(30); 

matriz.Scale(4, 8, MatrixOrder.Append); 
matriz.Translate(xCentro, yCentro, MatrixOrder.Append); 
// Dibujar 

GraphicsPath tr = new GraphicsPath(); 

tr.AddLine(0, 0, 100, 40); 

tr.Transform(matriz); 

g.DrawPath(Pens.Blue, tr); 


En este ejemplo, la transformación se aplica solo al objeto tr y no se aplica, 
como en el caso anterior, al objeto Pen. 


La clase Graphics proporciona varios métodos para generar una transforma- 
ción compuesta: MultiplyTransform, RotateTransform, ScaleTransform, 
TranslateTransform y ResetTransform. Según esto, el ejemplo anterior podría 
escribirse también así: 


g.RotateTransform(30); 

g.ScaleTransform(1, 2, Matrix0Order.Append); 
g.Translatelransform(xCentro, ylentro, Matrix0Order.Append); 
g.DrawLine(Pens.Blue, 0, 0, 100, 40); 


Tipos de sistemas de coordenadas 


GDI+ utiliza tres espacios de coordenadas: universales, de página y de dispositi- 
vo. Cuando se realiza la llamada a g.DrawLine(Pens. Blue, 0, 0, 100, 40), los pun- 
tos que se pasan al método DrawLine, (0, 0) y (100, 40), se encuentran en el 
espacio de coordenadas universales. Antes de que GDI+ pueda dibujar la línea en 
la pantalla, las coordenadas tienen que pasar por una secuencia de transformacio- 
nes: una para convertirlas de universales a coordenadas de página, y otra para 
convertirlas de coordenadas de página a coordenadas de dispositivo. 


La transformación universal está definida por la propiedad Transform del 
objeto Graphics. El objeto Matrix que define el valor por omisión de esta trans- 
formación es (1, 0, 0, 1, 0, 0), en la que se puede observar que el escalado es 1, la 
rotación 0 y la traslación 0. Y la transformación de página se manipula a través de 
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las propiedades PageUnit, cuyo valor pertenece a la enumeración GraphicsUnit, 
y PageScale de Graphics. 


La unidad de medida en el espacio de coordenadas universales quedará defi- 
nida por el tamaño que se dé a la superficie lógica de dibujo (véase más adelante, 
en Ejercicios resueltos, la representación de funciones). El espacio de coordena- 
das de página (coordenadas de la superficie de dibujo), por definición, tiene el 
origen en la esquina superior izquierda del área del cliente y la unidad de medida, 
por omisión, es Display: píxel para la pantalla. Este espacio coincidirá con el es- 
pacio de coordenadas del dispositivo cuando la unidad de medida en este último 
sea también el píxel, como ocurre con la pantalla. 


Transformaciones de color 


Cada píxel en una superficie GDI+ se representa como un vector de 5 dimensio- 
nes p = (r, g, b, a, w), donde r, g, b son las componentes de color, comprendidas 
entre 0 y 1; a (alfa) es la componente de transparencia, que tiene valores entre 0 
(totalmente transparente) y 1 (opaco); y w, necesaria para poder hacer transforma- 
ciones genéricas, vale siempre 1. Pues bien, un píxel p de una superficie se trans- 
forma en otro píxel p’ mediante la relación: 


p'=pC 


donde C es una matriz de transformación 5x5 especificada por el usuario, como se 
muestra a continuación, y encapsulada en un objeto de la clase ColorMatrix: 


Q 
II 
3 
3 
3 
3 
-00o0o0 


La última columna debe ser (0, 0, 0, 0, 1) para que el píxel resultante sea ho- 
mogéneo; es decir, tenga w= 1. La quinta fila de la matriz normalmente también 
es (0, 0, 0, 0, 1). 


Veamos, por ejemplo, qué ocurre cuando transformamos un píxel genérico 
(r, g, b, 1, 1), según la siguiente matriz de transformación: 


(lr g b 1 1x 
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o 0 0 
n Bar O 0 0 
n g& b 0 0|= 
0 0 1 0 
0 0 0 1 


(rro + gri + bro, rgo + gg; + bg», rbo + gb; + bbz, 1, 1)= (°, g’, b’, 1,1) 


En el resultado se observa que: 


e La componente r’ del vector resultante depende solo de los elementos de la 
primera columna de la matriz. 
e La componente g’, de los de la segunda columna. 
e La componente b’, de los de la tercera columna. 
e Y la componente a, de los de la cuarta columna. 


De ahí que a la primera columna se la llame r, a la segunda g, a la tercera b y 


a la cuarta a. 


Entonces, si en la matriz hacemos r; = g; = b;, para i = 0, 1 y 2, obtenemos una 
transformación con los valores r, g, b de cada pixel idénticos, independientemente 
del color del píxel original, lo cual define una escala de grises. El siguiente ejem- 
plo sería una aplicación de lo expuesto: 


private void OpcionesEscalaDeGrises_Click(object sender, EventArgs e) 


( 


Image ¡imagen 


= cilmagen. Image; 


using (Graphics gfx = Graphics.FromImage(imagen)) 


( 


// Matri 


{ 
new f] 
new f] 
new f] 
new f] 
new f] 
¡0 


ImageAttrib 
ia.SetColor 





// Utili 


z para realizar una transformación a escala de grises 
// manteniendo los valores de luminancia. 
ColorMatrix cm = new Color 


oat[ 
oat[ 


oa 


oat[ 
oat[ 


zar el método Draw 





TEOS Fe 0.3, 0 
[3(10.59f, 0.59f, 
ELIO IAE OLIT 
110, 0,0, 1, 0 
07 Dis 0 0 
tes ia = new I 
atrix(cm); 











atrix(new float[][] 


IIN a A 
059€, 0, 0, 
0.11f, 0, 0), 
kx 

) 


ageAttributes(); 


mage de gfx para volver a dibujar la 


// imagen utilizando los atributos especificados por ia 
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gfx.DrawImage(imagen, 
new Rectangle(0, 0, imagen.Width, imagen.Height), 
0, 0, imagen.Width, imagen.Height, 
GraphicsUnit.Pixel, ia); 
) 
cilmagen.Refresh(); 


} 


Análogamente, si queremos una transformación para obtener una escala de ro- 


jos, no tendremos más que tomar g = b = 0 , de forma que el píxel resultante ten- 
drá solamente componente r. Los valores que elijamos para ro, ri y r 
determinarán las demás propiedades de la imagen resultante (luminosidad, con- 
traste, etc.). 


Como último ejemplo, se puede demostrar que la matriz 


1 0 0 0-0 
0 1 0 0-0 
C=|0 0 1 0-0 
0 0 0 05 0 
0 0 0 0. 1 


convierte una imagen en semitransparente ya que deja las componentes r, g, b 
inalteradas y multiplica a por 0,5. 


MOSTRAR IMÁGENES 


Desarrollando con .NET se puede dibujar en casi todos los controles. No obstante, 
lo normal es dibujar en un formulario, objeto de la clase Form, o en una caja de 
imagen, objeto de la clase PictureBox. 


En los ejercicios realizados anteriormente en este capítulo hemos visto cómo 
dibujar gráficos vectoriales tanto en un formulario como en una caja de imagen. 
Ahora vamos a ver cómo mostrar una imagen almacenada como mapa de bits. 


Mapas de bits 


Un mapa de bits es una matriz rectangular que almacena el color de cada pixel del 
mapa. El número de bits asignado a un pixel individual determina el número de 
colores que se pueden asignar a dicho pixel. Por ejemplo, si cada píxel se repre- 
senta con 24 bits, a un pixel determinado se le podrá asignar uno entre los 2^24 = 
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16.777.216 colores distintos. La siguiente figura muestra un mapa de bits que al- 
macena los colores de los píxeles (8x8 píxeles de 24 bits) que forman el mapa: 


O“ OO. 0 oO 





0 
0 
0 
0 
0 
0 
0 
0 
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FOO OO0FFOO O0FFOO OOFFOO OOFFOO OOFFOO OOFFOO OOFFOO 
FOO FFFFFF FF0000 O000FF FFFFFF FF0000 0000FF O0FFOO 
FOO FFFFFF FF0000 O000FF FFFFFF FF0000 0000FF O0FFOO 
FOO FFFFFF FF0000 0000FF FFFFFF FF0000 0000FF O0FFOO 
FOO FFFFFF FF0000 0000fFF FFFFFF FF0000 0000FF O0FFOO 
FOO FFFFFF FF0000 O000FF FFFFFF FF0000 0000FF O0FFOO 
FOO FFFFFF FF0000 O000FF FFFFFF FF0000 0000FF O0FFOO 
FOO O0FFOO O0FFOO OOFFOO OOFFOO OOFFOO OOFFOO OOFFOO 
































En el mapa de bits, FFFFFF representa el blanco, FF0000 representa el rojo, 


00FFD0O representa el verde y 0000FF representa el azul. 


Existen muchos formatos estándar para almacenar mapas de bits en ficheros 


de disco. GDI+ soporta los siguientes: 


BMP. Bit MaP, mapa de bits. No suelen comprimirse, por lo que no son muy 
apropiados para que se transfieran a través de Internet. 


GIF. Graphics Interchange Format, formato de intercambio de gráficos. Se 
comprimen, sin que se pierda información, por lo que son muy apropiados pa- 
ra que se transfieran a través de Internet. Así mismo, se puede especificar un 
color como transparente, de forma que la imagen tenga el color de fondo de 
cualquier página web en la que se muestre, y puede almacenarse en un único 
fichero una secuencia de imágenes GIF para formar un GIF animado. Tienen 
una limitación y es que almacenan como máximo 8 bits por píxel, por lo que 
se limitan a 256 colores. 


JPEG. Joint Photographic Experts Group, grupo conjunto de expertos en fo- 
tografía. Son muy adecuados para fotografías escaneadas. Al comprimirlos se 
pierde algo de información, pero la pérdida suele ser imperceptible para el ojo 
humano. Se almacenan 24 bits por píxel y no admiten transparencia ni anima- 
ción. 


EXIF. Exchangeable Image File, fichero de imagen intercambiable. Son muy 
adecuados para fotografías que se capturan con cámaras digitales. Un fichero 
EXIF contiene una imagen comprimida conforme a la especificación JPEG y, 
además, almacena información acerca de la fotografía (fecha de toma, veloci- 
dad de obturación, tiempo de exposición, etc.) e información acerca de la cá- 
mara (fabricante, modelo, etc.). 


PNG. Portable Network Graphics, gráficos de red portátiles. El formato PNG 
supone una mejora con respecto al formato GIF por su capacidad para mostrar 
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una imagen progresivamente; es decir, para mostrar aproximaciones cada vez 
mejores de la imagen a medida que esta llega a través de una conexión de red. 
Al igual que los archivos GIF, los archivos PNG se comprimen sin que se 
pierda información. Pueden almacenar colores con 8, 24 o 48 bits por píxel y 
escalas de grises con 1, 2, 4, 8 o 16 bits por píxel, y también puede almacenar 
un valor alfa para cada píxel, que especifica el grado de mezcla de ese píxel 
con el color de fondo. 


e TIFF. Tag Image File Format, formato de fichero de imágenes con etiquetas. 
Pueden almacenar imágenes con un número arbitrario de bits por píxel y pue- 
den emplear varios algoritmos de compresión. 


Cargar y mostrar un mapa de bits 


Análogamente a la clase Metafile, que puede utilizarse para cargar y mostrar 
imágenes vectoriales, la clase Bitmap puede utilizarse para cargar y mostrar imá- 
genes de trama o mapas de bits. Ambas clases se derivan de la clase Image. Si pa- 
ra mostrar una imagen vectorial son necesarios un objeto Graphics (objeto que 
proporciona el método DrawImage) y un objeto Metafile (imagen a mostrar), pa- 
ra mostrar un mapa de bits, son también necesarios un objeto Graphics y la ima- 
gen a mostrar, que en este caso estará almacenada en un objeto Bitmap. 


Como ejemplo, vamos a construir una aplicación que haga las veces de un vi- 
sor de imágenes sencillo. Su interfaz estará formada por una ventana con una ba- 
rra de menús, una barra de herramientas, una barra de estado, un panel con barras 
de desplazamiento y un control PictureBox para mostrar las imágenes. 


Inicie Visual C# y cree un nuevo proyecto para implementar el esqueleto para 
una nueva aplicación que utilice un formulario de tipo Form como ventana prin- 
cipal. Denomínela Visorlmags. Ponga al formulario como título “Visor de imáge- 
nes” y como nombre Forml. A continuación, añada las barras de menús 
(MenusStrip), de herramientas (ToolStrip) y de estado (StatusStrip). Después, 
complete la barra de menús con los elementos indicados en la tabla que se expone 
a continuación (el código completo lo encontrará en la carpeta Cap08Visorlmags 
del CD que acompaña al libro): 


Propiedad 


Archivo Name menuArchivo 
Text Archivo 


Text Abrir... 
Text Guardar como... 
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ArchivoCerrar 
Cerrar 


ArchivoSeparadorl 


ArchivoSalir 
Salir 


Cerrar 


Opciones menuOpciones 

Tamaño ajustado OpcionesTamAjustado 
AAA t Tamaño ajustado 

Tamaño real OpcionesTamkReal 
Misco 


Alejar 
OpcionesGirar90 
Copiar 
S£Ayuda 
Acerca de AyudaAcercaDe 
AR e l &Acerca de visor de imágenes... 


Una vez diseñada la barra de menús, añada un panel (objeto de la clase Pa- 
nel). A continuación, ajuste el tamaño del panel al tamaño del área de cliente del 
formulario (y lado a lado con la barra de herramientas). Después, asigne a su pro- 
piedad AutoScroll el valor true, para permitir barras de desplazamiento, a Dock 
el valor None y a Anchor los valores Top, Bottom, Left y Right. 








Name 
Name 
Name 
Name 
Name 
Acercar Name OpcionesAcercar 
AA A A O 

Text 

Name 
Name 
Name 
Name 





Finalmente, añada sobre el panel un control PictureBox. Asigne a su propie- 
dad Name el valor ci/magen, a su propiedad Location el valor (0, 0) y a su pro- 
piedad SizeMode el valor 4utoSize. 


¿Por qué no hemos añadido el PictureBox directamente sobre el formulario, 
poniendo la propiedad AutoSeroll de este a true? Porque los controles Strip, por 
ejemplo MenuStrip, residen en el área de cliente (sus homólogos, por ejemplo 
MainMenu, residen en el área de no cliente) y serían desplazados al actuar sobre 
las barras de desplazamiento del formulario. 


Un control PictureBox permite mostrar gráficos almacenados en un fichero 
de mapa de bits, metarchivo o icono. Para mostrar un gráfico basta con asignar a 
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su propiedad Image, durante el diseño o durante la ejecución, el objeto Image que 
desea mostrar. La forma en la que tiene lugar la presentación es controlada por la 
propiedad SizeMode; los valores de esta propiedad son definidos por la enumera- 
ción PictureBoxSizeMode: 


e  AutoSize. El tamaño del PictureBox debe ajustarse al tamaño de la imagen 
que contiene. 


e  Centerlmage. La imagen se muestra en el centro si el tamaño del PictureBox 
es mayor que el de la imagen. Si la imagen es más grande, se coloca en el 
centro del PictureBox y se recortan los bordes exteriores. 


e Normal. La imagen se coloca en la esquina superior izquierda del Picture- 
Box. Si la imagen es más grande que el objeto PictureBox que la contiene, se 
recorta. 


e  Stretchlmage. La imagen se ajusta al tamaño del PictureBox estirándose o 
contrayéndose lo necesario. 


e Zoom. El tamaño de la imagen aumenta o disminuye en función del tamaño 
del PictureBox pero manteniendo la misma proporcionalidad. 


Se puede cambiar el tamaño del área de presentación en tiempo de ejecución 
con la propiedad Size/ClientSize. Para proporcionar un borde estándar o tridi- 
mensional, utilice la propiedad BorderStyle. 


Siguiendo con el desarrollo de la aplicación, vamos a implementar las órdenes 
del menú Archivo. La orden Salir simplemente tiene que invocar al método Close 
de Forml para cerrar el formulario y la orden Cerrar asignará a la propiedad 
Image del PictureBox el valor null. 


La orden Abrir tiene que permitir cargar un fichero bmp, gif, jpeg (o jpg), 
png, exif o tiff y mostrarlo en la caja de imagen cilmagen. Para ello, añada el con- 
trolador correspondiente y edítelo como se muestra a continuación: 


private void ArchivoAbrir_Click(object sender, EventArgs e) 


( 
OpenFileDialog DIgAbrir = new OpenFileDialog(); 


DIgAbrir.InitialDirectory = Directory.GetCurrentDirectory(); 

DlgAbrir.Filter = "Ficheros BMP|*.bmp” + 
"|Ficheros GIF|*.gif" + 
"|Ficheros JPG o JPEG|*.jpg;*.jpeg" + 
"|Ficheros PNG|*.png" + 
"|Ficheros EXIF|*.exif" + 
"|Ficheros TIFF|*.tiff"; 

DlgAbrir.Filterindex = 3; 
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// Mostrar el diálogo Abrir 
if (DIgAbrir.ShowDialog() == DialogResult.0K) 
cilmagen.Image = Image.FromFile(DlgAbrir.FileName); 


La propiedad Image del control PictureBox es un objeto Image que contiene 
el mapa de bits actual y expone propiedades y métodos que permiten manipular 
esta imagen (en el caso de un formulario hablaríamos de la propiedad Back- 
groundImage). FromFile crea un objeto Image a partir del fichero especificado. 
También, como la clase Bitmap está derivada de Image, puede crear un objeto 
Bitmap y asignárselo a la propiedad Image: 


Bitmap mapaDeBits = new Bitmap(DlgAbrir.FileName); 
cilmagen.Image = mapaDeBits; 


La orden Guardar como tiene que permitir guardar una imagen en un fichero 
bmp, gif, jpeg (o jpg), png, exif o tiff. Para ello, añada el controlador correspon- 
diente y edítelo como se muestra a continuación: 


private void ArchivoGuardarComo_Click(object sender, EventArgs e) 
( 
SaveFileDialog DlgGuardar = new SaveFileDialog(); 


DlgGuardar.InitialDirectory = Directory.GetCurrentDirectory(); 

DlgGuardar.Filter = "Ficheros BMP|*.bmp" + 
"|Ficheros GIF|*.gif" + 
"|Ficheros JPG o JPEG|*.jpg;*.jpeg" + 
"|Ficheros PNG|*.png" + 
"|Ficheros EXIF|*.exif" + 
"[Ficheros TIFF|*.tiff"; 

DlgGuardar.Filterlndex = 3; 











if (DlgGuardar.ShowDialog() == DialogResult.0K) 
( 








// Guardar la imagen el fichero 
ImageFormat formato = ImageFormat.yJpeg; 
switch (DlgGuardar.Filterlndex) 
( 
case 
formato = ageFormat.Bmp; 
break; 
case 2: 
formato = ageFormat.Gif; 
break; 
case 3: 
formato = ageFormat.Jpeg; 
break; 
case 4: 
formato = ageFormat.Png; 
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break; 

case 5: 

formato = ImageFormat.Exif; 
break; 
case 6: 
formato = ImageFormat.Tiff; 
break; 





) 
cilmagen.Image.Save(DlgGuardar.FileName, formato); 
) 





} 


Para guardar una imagen hay que utilizar el método Save del objeto Image 
que contiene dicha imagen. Este método presenta varias formas; la que hemos uti- 
lizado aquí tiene dos parámetros: el nombre del fichero y el formato con el que se 
guardará la imagen. Los diferentes formatos están definidos en la clase Image- 
Format perteneciente al espacio de nombres System.Drawing.Imaging, por lo 
que si no se quiere utilizar el nombre completo para el formato deseado, habrá que 
declarar que se va a utilizar esta biblioteca. 


A continuación, vamos a implementar las órdenes del menú Opciones. La or- 
den Tamaño ajustado tiene que presentar la imagen haciendo que su tamaño sea 
proporcional al tamaño de la caja de imagen; lógicamente, conservando la propor- 
cionalidad entre la anchura y altura de la imagen. Esto exige que el control Pictu- 
reBox se redimensione al tamaño del área de cliente de la ventana y que la 
propiedad SizeMode del PictureBox tenga el valor Zoom. La propiedad Auto- 
ScrollPosition del panel se utiliza, cuando sea necesario, para ajustar la posición 
del control contenido (PictureBox) en el control desplazable. Según lo expuesto, 
añada el controlador de esta orden y edítelo como se muestra a continuación: 


private void OpcionesTamAjustado_Click(object sender, EventArgs e) 
( 

if (cilmagen.Image == null) return; 

cilmagen.Size = Panell.Size; 

cilmagen.SizeMode = PictureBoxSizeMode.Zoom; 
) 


La orden Tamaño real tiene que presentar la imagen haciendo que su tamaño 
sea el real, lo que se consigue asignando el valor 4utoSize a la propiedad Si- 
zeMode del PictureBox. Según lo expuesto, añada el controlador de esta orden y 
edítelo como se indica a continuación: 


private void OpcionesTamReal_Click(object sender, EventArgs e) 
( 

if (cilmagen.Image == null) return; 

cilmagen.SizeMode = PictureBoxSizeMode.AutoSize; 
) 
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Las órdenes Acercar y Alejar tienen que aumentar y disminuir, respectiva- 
mente, la anchura y la altura de la caja de imagen, cilmagen, en la misma propor- 
ción y, a continuación, ajustar la imagen al nuevo tamaño, lo que se consigue 
asignando el valor StretchImage a la propiedad SizeMode del PictureBox. Según 
lo expuesto, añada los controladores de estas órdenes y edítelos como se indica a 
continuación: 


private void OpcionesAcercar_Click(object sender, EventArgs e) 
( 
if (cilmagen.Image == null) return; 
// Relación ancho/alto de la imagen 
double k (double)cilmagen.Image.Width / cilmagen.Image.Height; 
// Para una imagen proporcional debe cumplirse que: 
// cilmagen.Width / cilmagen.Height sea igual a k 
int nuevoAncho = Convert.Tolnt32(cilmagen.Width * 1.25); 
cilmagen.Width nuevoAncho; 
cilmagen.Height = Convert.Tolnt32(nuevoAncho / k); 
cilmagen.SizeMode = PictureBoxSizeMode.StretchImage; 














} 


private void OpcionesAlejar_Click(object sender, EventArgs e) 
{ 
if (cilmagen.Image == null) return; 
// Relación ancho/alto de la image 
double k (double)ciImagen.Image.Width / ciImagen.Image.Height; 
// Para una imagen proporcional debe cumplirse que: 
// cilmagen.Width / cilmagen.Height sea igual a k 
int nuevoAncho = Convert.Tolnt32(cilmagen.Width / 1.25); 
cilmagen.Width = nuevoAncho; 
cilmagen.Height = Convert.Tolnt32(nuevoAncho / k); 
cilmagen.SizeMode = PictureBoxSizeMode.StretchImage; 











La orden Girar 90” tiene que rotar la imagen 90 grados en el sentido de las 
agujas del reloj. Este proceso requiere llamar al método RotateFlip (rotar/voltear) 
de la caja de imagen con el argumento Rotate90FlipNone. A continuación hay que 
invocar al método Invalidate del PictureBox para que se repinte y muestre los 
cambios. Según lo expuesto, añada el controlador de esta orden y edítelo como se 
indica a continuación: 


private void OpcionesGirar90_Click(object sender, EventArgs e) 
( 


if (cilmagen.Image == null) return; 


cilmagen.Image.RotateFlip(RotateFlipType.Rotate90FlipNone); 
cilmagen.Invalidate(); 


} 
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Intercambiar imágenes a través del portapapeles 


Muchas aplicaciones utilizan el portapapeles (clipboard) como repositorio tempo- 
ral para los datos de diferentes tipos (texto, imágenes, etc.). Por ejemplo, en el ca- 
pítulo 4 lo utilizamos en la aplicación Editor para dotarla de las operaciones 
cortar, copiar y pegar. En una aplicación Windows, el acceso al portapapeles y el 
almacenamiento de datos en él es posible mediante el uso de los métodos SetDa- 
taObject, que almacena los datos en el portapapeles, y GetDataObject, que re- 
cupera los datos del portapapeles utilizando la interfaz IDataObject. El método 
SetDataObject funciona de forma que, más adelante, se pueden recuperar los da- 
tos del portapapeles en diversos formatos. Estos métodos pertenecen a la clase 
Clipboard del espacio de nombres System.Windows.Forms. 


La clase Clipboard proporciona el acceso al portapapeles y el almacenamien- 
to de imágenes en él es posible mediante el uso de los métodos SetImage, que 
almacena la imagen en el portapapeles, y GetImage, que recupera la imagen del 
portapapeles. Para determinar si el formato de los datos se corresponde con el de 
una imagen, utilizaremos el método ContainsImage. Por ejemplo: 


if (Clipboard.ContainsImage()) 

( 
mapaDeBits = (Bitmap)Clipboard.GetImage(); 
Clipboard.Clear(); 

) 


Según lo expuesto, escriba el controlador del evento Click de la orden Copiar 
como se indica a continuación: 


private void OpcionesCopiar_Click(object sender, EventArgs e) 
( 
if (cilmagen.Image == null) return; 
Clipboard.SetImage(cilmagen.Image); 
) 


Finalmente, añada el controlador de la orden Acerca de..., del menú Ayuda 
para que muestre un diálogo con los créditos de la aplicación. 


private void AyudaAcercaDe_Click(object sender, EventArgs e) 

( 
String mensaje = "Visor de imágenes. Versión 1.1" + 
Environment.NewlLine + "Copyright (c) Fco. Javier Ceballos, 2007"; 
MessageBox.Show(mensaje, "Acerca de Visor de imágenes"); 


} 
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Puede utilizar una caja de diálogo predefinida, como la que muestra el método 
anterior, o una caja de diálogo personalizada, como la que muestra el método si- 
guiente: 


private void AyudaAcercaDe_Click(object sender, EventArgs e) 
( 

(new AcercaDe()).ShowDialog(); 
) 





Visorlmags 


Versión 1.1.0.0 


Copyright Fco. Javier Ceballos, 2010 


FJCS 


Puede ver sus fotos en tamaño real o en otro 
tamaño, guardarlas con otro formato o copiarlas al 
portapapeles. 





Para añadir este formulario a la aplicación, diríjase al explorador de solucio- 
nes, haga clic con el botón secundario del ratón sobre el nombre del proyecto, se- 
leccione Agregar > Formulario Windows > Acerca de. Asígnele el nombre 
AcercaDe. Los datos que visualiza este formulario en sus etiquetas son proporcio- 
nados por el fichero AssemblyInfo.cs del proyecto. No obstante, puede editarlos y 
adaptarlos a sus requerimientos. Para ello, haga clic con el botón secundario del 
ratón sobre el nombre del proyecto, seleccione Propiedades > Aplicación > In- 
formación de ensamblado, y añada la información que desee en el diálogo que se 
visualiza. 


CAMBIAR LA FORMA DEL PUNTERO DEL RATÓN 


Para informar al usuario de la operación que realizará el ratón, se utilizan distintas 
imágenes del puntero del ratón, también llamadas “cursores”. Por ejemplo, al edi- 
tar o seleccionar texto, suele mostrarse un cursor vertical (Cursors.IBean) y para 
informar al usuario de que se está ejecutando un proceso, se utiliza un reloj de 
arena (Cursors. WaitCursor). Esta imagen está definida por un objeto de la clase 
Cursor. Así mismo, la clase Cursors proporciona varios cursores predefinidos. 
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Por otra parte, todos los controles que se derivan de la clase Control tienen 
una propiedad Cursor que hace referencia a la imagen que muestra el puntero del 
ratón cuando está dentro de los límites del control (la clase Form también se deri- 
va, indirectamente, de la clase Control). Para cambiarlo, seleccione el control, o 
el formulario, y asigne a su propiedad Control la forma deseada del cursor. El 
código que se genera tras una acción de este tipo es análogo al siguiente (vea el 
ejercicio “tablero de dibujo” en el apartado de Ejercicios propuestos): 


this.Panel.Cursor = System.Windows.Forms.Cursors.Cross 


Alternativamente, puede mostrar cursores personalizados. Para ello, añada al 
proyecto un nuevo elemento de tipo “archivo de cursor” (fichero .cur), dibuje la 
forma del cursor y guárdelo. Después, seleccione este fichero en el explorador de 
soluciones, diríjase a la ventana de propiedades y elija “recurso incrustado” como 
acción de generación. Finalmente, añada una línea de código análoga a la siguien- 
te en el lugar adecuado (por ejemplo, en el manejador del evento Load del formu- 
lario, en el constructor de este, etc.). 


this.Cursor = new Cursorí(this.Getlype(), "imagenes.Cursorl.cur"); 


Este ejemplo establece el cursor Cursorl.cur almacenado en la carpeta ima- 
genes del proyecto. Otra alternativa que no requiere incrustar el recurso es: 


this.Cursor = new Cursor("imagenes/Cursorl.cur"); 


EJERCICIOS RESUELTOS 


1. Representación de funciones. En ocasiones necesitaremos representar funciones o 
conjuntos de datos suministrados por el usuario. Por ejemplo, en la figura siguien- 
te puede observar la representación de la función: 7+23 xsen(0.8 xx) xsen(10/x). 





iJ Representación de una función 





Valores de X 
Min 0,83 


Máx 6.30 
Calidad 


Normal 


© Alta 

















7+23” Sin(0.8” X) * Sin(10 /X) 
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La superficie de dibujo es un control PictureBox (en el código lo identifica- 
remos por ciFuncion), la calidad del gráfico se puede elegir entre normal y alta, y 
la función que se dibuja se muestra en una etiqueta en el fondo de la ventana. El 
intervalo de la variable X en el que se representa la función viene dado por los va- 
lores especificados en las cajas etiquetadas con Mín y Máx. Puede ver el desarro- 
llo de la aplicación completa en la carpeta Cap0SlResueltos| Funciones del CD 
que acompaña al libro. 


Obsérvese el rango empleado en la figura anterior para representar la función: 
valores de X entre —0,83 y 6,30. Pero también podríamos haber elegido otro ran- 
go, por ejemplo, entre 0 y 5000. Esto nos lleva a pensar que si utilizáramos como 
unidades píxeles, muchos gráficos no entrarían en la superficie de dibujo. Es po- 
sible especificar las coordenadas en otras unidades y dejar que la GDI+ las con- 
vierta en píxeles antes de dibujar; para ello tendremos que especificar el factor de 
escala para los ejes X e Y. 


Fíjese en la superficie de dibujo de la figura anterior. Presenta los ejes X e Y 
de coordenadas que definen el origen (0, 0) lógico. Conocemos los valores míni- 
mo y máximo de X (Xmin y Xmax) y podemos calcular los valores mínimo y má- 
ximo de Y (Ymin e Ymax): 


Ymin = ValorfFuncion(Xmin):; 
Ymax = ValorfFuncion(Xmin):; 
for (t = Xmin; t <= Xmax; t += (Xmax - Xmin) / (ciFuncion.Width - 3)) 
{ 
val = ValorFuncion(t); 
Ymax = Math.Max(val, Ymax); 
Ymin = Math.Min(val, Ymin); 
) 


S1 la curva se extiende verticalmente desde Ymin a Ymax y la superficie de di- 
bujo de O a ciFuncion. Width — 3 píxeles (-3 para evitar dibujar sobre el borde), 
hay que escalar el gráfico para que llene esta superficie. Este factor de escala 
permitirá convertir las unidades del eje X y del eje Y en píxeles: 


matriz = new Matrix(); 
matriz.Scale(((ciFuncion.Width - 3) / (Xmax - Xmin)), 
-(ciFuncion.Height - 3) / (Ymax - Ymin)); 


El escalado iguala las superficies lógica (delimitada por los valores X e Y má- 
ximos y mínimos de la función) y física (tamaño de ciFuncion). El signo menos 
del factor de escala de Y hace que los valores en este eje crezcan hacia arriba. 


El origen (0, 0) físico está situado en la esquina superior izquierda del control, 
y el origen (0, 0) lógico está en otra posición dentro de la superficie de dibujo. La 
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coordenada física 0,83 debe corresponderse con la coordenada lógica x cero. Esto 
es, la coordenada lógica x cero será transformada, mediante una transformación de 
desplazamiento, en el píxel correspondiente a la coordenada física x 0,83: 


coordenada lógica x + 0,83 = coordenada física x 


Según lo expuesto, la transformación de desplazamiento en X es —(Xmin), esto 
es, (0,83) = 0,83, que coincide con el (Amin). Para el eje vertical haríamos un 
razonamiento análogo, llegando a la conclusión de que la transformación de des- 
plazamiento en Y es (Ymax). 


matriz.Translate(-Xmin, -Ymax) 


Combinemos ahora las dos transformaciones. Para el ejemplo concreto sobre 
el que estamos trabajando, (Xmax — Xmin) = (6,3 — (50,83)) = 7,13. ¿Cómo se 
traducirán, por ejemplo, las coordenadas lógicas x de los extremos del eje X? Esto 
es, Amin y Xmax. 





(-0,83 + 0,83 


) x (ciFuncion. Width - 3) / 7,13 =0 
(6,3 + 0,83) x ( 


ciFuncion.Width - 3) / 7,13 = (ciFuncion.Width - 3) 


El resultado es el esperado: el píxel con la coordenada física x cero y el píxel 
con la coordenada física x ancho de la superficie de dibujo. Obsérvese que la 
transformación de desplazamiento se aplica antes que la de escalado. Se deduce 
entonces que la transformación total vendrá dada por las siguientes operaciones: 


matriz.Scale(((ciFuncion.Width - 3) / (Xmax - Xmin)), 
-(ciFuncion.Height - 3) / (Ymax - Ymin)); 
matriz.Translate(-Xmin, -Ymax); 


lo cual, podría especificarse también así: 


matriz.Translate(-Xmin, -Ymax); 

matriz.Scale(((ciFuncion.Width - 3) / (Xmax - Xmin)), 
-(ciFuncion.Height - 3) / (Ymax - Ymin), 
Matrix0Order.Append); 


Una vez comprendido cómo traducir los puntos de la función a píxeles, vea- 
mos el código. En primer lugar calcularemos los valores mínimo y máximo de X 
(Xmin y Xmax) y mínimo y máximo de Y (Ymin e Ymax). Obsérvese que los valo- 
res de la función se calculan para tantos puntos como píxeles hay a lo largo del eje 
X; no tiene sentido calcular el valor de la función para más puntos de los existen- 
tes. A continuación, se establecen las transformaciones en el objeto matriz. Des- 
pués, se construyen los trazados para los ejes y para la función. Y finalmente, se 
dibujan esos trazados aplicándoles la transformación definida por matriz (trans- 
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formación local) para que las coordenadas universales (world) se conviertan en 
coordenadas en píxeles. 


private void ciFuncion_Paint(object sender, PaintEventArgs e) 
( 

Graphics g = e.Graphics; 

g.Clearí(ciFuncion.BackColor); 


float t; 
float Xmin, Xmax; 
float Ymax, Ymin; 


Xmin = Convert.ToSingle(ctXMin.Text):; 
Xmax = Convert.ToSingle(ctXMax.Text):; 
¡ 
( 











if (Xmin >= Xmax) 


MessageBox.Show("X máx tiene que ser mayor que X mín"); 
return; 

) 

float val; 

Ymin = ValorFuncion(Xmin); 

Ymax ValorFuncion(Xmin):; 


// Calcular el valor de la función para cada píxel en el eje X 
// y obtener el valor máximo y mínimo 
for (t = Xmin; t <= Xmax; t += (Xmax - Xmin) / (ciFuncion.Width - 3)) 
( 
val = ValorFuncion(t); 
if (float.IsInfinityíval) || float.IsNaN(val)) 
( 
MessageBox.Show("No se puede dibujar la función en este rango"); 
return; 
) 
Ymax = Math.Max(val, Ymax); 
Ymin Math.Min(val, Ymin); 
) 


// matriz vale inicialmente: 100100 

matriz = new Matrix(); 

// Scale modifica los valores primero y cuarto 

matriz.Scale(((ciFuncion.Width - 3) / (Xmax - Xmin)), - 
(ciFuncion.Height - 3) / (Ymax - Ymin)); 

// Translate modifica los valores quinto y sexto 

matriz.Translate(-Xmin, -Ymax); 





// Trazados para los ejes 

GraphicsPath Ejex = new GraphicsPath(); 

GraphicsPath EjeY = new GraphicsPath(); 
EjeX.AddLine(new PointF(Xmin, 0), new PointF(Xmax, 0)); 
EjeY.AddLine(new PointF(0, Ymax), new PointF(0, Ymin)); 
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// Trazado para la función 

float XAnterior, YAnterior; 

float X, Y; 

// Cada segmento en el trazado va desde (XAnterior, YAnterior) a (X, Y) 
GraphicsPath Función = new GraphicsPath(); 

Pen lápiz = new Pen(Color.Black, 1); 

// Punto inicial 

XAnterior = Xmin; 

YAnterior ValorfFuncion(Xmin); 

// Segmentos que forman el trazado de la función 

for (t = Xmin; t <= Xmax; t += (Xmax - Xmin) / (ciFuncion.Width - 3)) 
( 


X ES 
Y = ValorFuncion(t); 
Función.AddLine(XAnterior, YAnterior, X, Y); 
XAnterior = X; 

YAnterior = Y; 





) 


// Establecer la calidad con la que se dibujará 
g.SmoothingMode = calidad; 








// Dibujar todo aplicando transformaciones locales 
EjeX.Transformí(matriz); 

g.DrawPath(lápiz, EjeX); // Eje X 

EjeY.Transtfo 





rm(matriz); 
g.DrawPath(lápiz, EjeY); // Eje Y 
lápiz.Color = Color.Blue; 
Función.Transformímatriz); // Función 
g.DrawPath(lápiz, Función); 














Vamos a introducir en la aplicación una línea vertical desplazable a lo largo 
del eje X, que actúe como un cursor para seleccionar un punto del cual deseamos 
conocer sus coordenadas. El resultado puede verse en la figura mostrada un poco 
más adelante. 


Las coordenadas del punto seleccionado se visualizarán cada una de ellas en 
una caja de texto. Observe en la figura la caja de grupo Punto. 


El problema planteado se resuelve utilizando los eventos del ratón Mouse- 
Move y MouseUp. 


El problema de pintar una línea vertical desplazable a lo largo del eje X está 
resuelto de forma aislada en la carpeta Cap08 Resueltos lEventosRaton del CD que 
acompaña al libro. A continuación explicamos cómo incorporar esta técnica a la 
aplicación que estamos desarrollando. 
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Representación de una función 





Valores de X 
Mín -0,83 
Máx 6.30 
Calidad 

© Normal 


5 Alta 











7 +23” Sin(0.8” X) * Sin(10 /X) 





El cursor se pintará al hacer clic y mover el ratón con el botón izquierdo pul- 
sado hacia la derecha o hacia la izquierda en la superficie de dibujo. Según esto, el 
controlador del evento MouseMove tiene que almacenar en los atributos x1, y1, 
x2 e y2 de la clase Form1 las coordenadas del cursor que pintará el método ciFun- 
cion_Paint, solo si el botón izquierdo del ratón está pulsado. Para ejecutar el mé- 
todo ciFuncion_ Paint, ciFuncion _MouseMove invocará al método Invalidate. 


private void ciFuncion_MouseMove(object sender, MouseEventArgs e) 
( 
if (e.Button == MouseButtons.Left) 
( 
botonPulsado = true; 
// Coordenadas del cursor a dibujar 


xl = e.X; 

yl = 0; 

x2 = e.X; 

y2 = ciFuncion.Height; 


ciFuncion.Invalidate(); 


El controlador del evento MouseUp se ejecutará al soltar el botón del ratón y 
tiene como misión borrar el último cursor pintado, así como el contenido de las 
cajas de texto etiquetadas con X e Y. 


private void ciFuncion_MouseUp(object sender, MouseEventArgs e) 
{ 

botonPulsado = false; 

ciFuncion.Invalidate(); // borrar el cursor 

ctCoordX.Text = ""; 

ctCoordY.Text = ""; 
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Añada al método ciFuncion Paint el código que se muestra a continuación y 
que tiene como finalidad pintar un cursor para seleccionar un punto de la función 
y mostrar sus valores x e y, solo si el botón izquierdo del ratón está pulsado. 


private void ciFuncion_Paint(object sender, PaintEventArgs e) 
( 
/1 


// Si el botón del ratón está pulsado, dibujar el cursor 
if (botonPulsado) 
{ 
g.DrawLine(Pens.Red, x1, yl, x2, y2); 
// Convertir píxeles a coordenadas lógicas 
float x1log = Xmin + x1 * (Xmax - Xmin) / (ciFuncion.Width - 3); 
// Mostrar las coordenadas en las cajas de texto 
ctCoordX.Text = string.Format("{0:F2}", x11lo0g); 
ctCoordY.Text string.Format("(0:F2)", ValorFuncion(x1log)); 





2. Animación. Las animaciones pueden suponer un medio eficaz para comunicar 
información visual. Puede usar la animación para ilustrar el funcionamiento de 
una herramienta, reflejar un estado concreto, mostrar el progreso de una opera- 
ción, indicar un proceso en segundo plano, etc. Como ejemplo, y con la intención 
de presentarle cómo se realiza esta técnica, vamos a escribir una aplicación que 
presente una ventana, según muestra la figura siguiente, con una superficie sobre 
la que corre una bola; cuando la bola llega a los límites de la superficie sobre la 
que rueda, invertirá su dirección. Puede ver el desarrollo completo de esta aplica- 
ción en la carpeta Cap08\Resueltos\Animacion del CD que acompaña al libro. 

















Cuando se inicie la aplicación, lo primero que hay que hacer es crear la bola 
que después se pintará sobre la superficie de dibujo. Para crear la bola se invocará 
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desde el controlador del evento Load al método CrearNuevaBola. Este método 
realizará las siguientes operaciones: 


1. 


4, 


5. 


Calculará el radio de la bola para que sea proporcional al tamaño de la super- 
ficie de dibujo (16 veces menor que la anchura o altura de la superficie de di- 
bujo; se elegirá la menor). Lo que se persigue es que cuando el usuario 
redimensione la ventana se redimensione la bola en la misma proporción. 


Calculará los píxeles que avanzará la bola en las direcciones X e Y en cada 
movimiento. Este valor estará entre uno y la cuarta parte del radio de la bola. 


Calculará el tamaño del mapa de bits que incluirá la bola, de forma que añada 
un margen alrededor de la misma, del mismo color que la superficie de dibu- 
jo, igual a la distancia que avanzará la bola en cada movimiento. Con esto se 
garantiza que la siguiente imagen dibujada borre la anterior. 


Creará el mapa de bits y pintará la bola en la superficie de dibujo. 


Finalmente, fijará la posición inicial de la bola. 


private void CrearNuevaBola() 


( 


// Superficie de dibujo 
Graphics g = PictureBox1.CreateGraphics(); 
g.Clear(PictureBox1.BackColor); 


// Radio de la bola proporcional al tamaño de la superficie de dibujo 
double min = Math.Min(PictureBox1.ClientSize.Width / g.DpiX, 

PictureBox1.ClientSize.Height / g.DpiY); 
double radioBola = min / CteProporBola; // pulgadas 


// Ancho y alto de la bola en píxeles 
radioXBola = Convert.Tolnt32(radioBola * g.DpiX); 
radioYBola = Convert.Tolnt32(radioBola * g.DpiY); 











g.Dispose(); // liberar los recursos utilizados por g 


// Píxeles que se mueve la bola en las direcciones X e Y. 
// Cantidades proporcionales a su tamaño. Mínimo 1 píxel. 
MovXBola = Math.Max(1, radioXBola / CteProporMov); 
MovYBola = Math.Max(1, radioYBola / CteProporMov)'; 


// Margen alrededor de la bola, del mismo color que la superficie 
// de dibujo. Haciendo el margen igual al movimiento de la bola, 
// garantizamos que la siguiente imagen dibujada borre la anterior. 
margenXMapaBits = MovXBola; 
margenYMapaBits MovYBola; 
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// Tamaño del mapa de bits incluyendo el margen. 
anchoMapaBitsBola = 2 * (radioXBola + margenXMapaBits); 
altoMapaBitsBola = 2 * (radioYBola + margenYMapaBits); 


// Crear el mapa de bits. 
mapaBits = new BitmaplanchoMapaBitsBola, altoMapaBitsBola); 


// Obtener el objeto Graphics expuesto por el Bitmap, limpiar 
// la superficie de dibujo, pintar la bola en el mapa de bits y 
// liberar los recursos utilizados por el objeto Graphics. 

g = Graphics.Fromlmage(mapaBits); 
g.Clear(PictureBox1.BackColor); 

g.FillEllipse(Brushes.Blue, new Rectangle(MovXBola, MovYBola, 

2 * radioXBola, 2 * radioYBola)); 





g.Disposel); 





// Posición inicial de la bola. 
posXBola = PictureBox1.ClientSize.Width / 2; 
posYBola = PictureBox1.ClientSize.Height / 2; 


Una vez creada la bola, se inicia la animación. Para ello, el controlador del 
evento Load pondrá en marcha un temporizador. El controlador de este tempori- 
zador, que se ejecutará cada 25 milisegundos, realizará las siguientes operaciones: 


1. Obtendrá el objeto Graphics correspondiente a la superficie por donde rodará 
la bola. 


2. Dibujará la bola en la posición fijada, haciendo coincidir esta posición con el 
centro de la bola, y calculará la siguiente posición. 


3. Verificará si la nueva posición, teniendo en cuenta además el radio de la bola, 
sobrepasa los límites de la superficie de dibujo, en cuyo caso habrá que cam- 
biar la dirección de la misma. 


private void Timerl1_Tick(object sender, EventArgs e) 
( 
// Obtener el objeto Graphics expuesto por PictureBoxl 
Graphics g = PictureBox1.CreateGraphics(); 
// Dibujar la bola en la superficie de dibujo 
g.DrawImage(mapaBits, 
posXBola - anchoMapaBitsBola / 2, 
posYBola - altoMapaBitsBola / 2, 
anchoMapaBitsBola, 
altoMapaBitsBola); 








// Liberar los recursos utilizados por el objeto Graphics 
g.Disposel); 
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// Siguiente posición de la bola 
posXBola += MovXBola; 
posYBola += MovYBola; 





// Invertir la posición de la bola cuando esta toque en los 

// límites de la superficie de dibujo 

if (posXBola + radioXBola >= PictureBox1.ClientSize.Width || 
posXBola - radioXBola <= 0) 





( 
MovXBola = -MovXBola; 
Console.Beep(3000, 20); 

) 

if (posYBola + radioYBola >= PictureBox1.ClientSize.Height || 

posYBola - radioYBola <= 0) 

( 
MovYBola = -MovYBola; 
Console.Beep(4000, 20); 

) 





} 


Observe que el efecto de animación se consigue pintando una imagen, bo- 
rrándola y volviéndola a pintar en una nueva posición. Repitiendo esta secuencia 
un número determinado de veces por segundo, conseguiremos el efecto deseado. 


Doble búfer. Las animaciones pueden producir parpadeo. Para mejorar la aparien- 
cia de las animaciones hay que evitar ese parpadeo, lo que se consigue con la téc- 
nica del doble búfer. La idea es sencilla: cuando estamos contemplando el 
contenido de uno de los búferes (la superficie de dibujo), se dibuja el nuevo gráfi- 
co en el otro búfer (una zona de memoria), una vez terminado el dibujo se inter- 
cambian los dos búferes (se copia el nuevo gráfico en la superficie de dibujo). Así 
siempre veremos una imagen estable. 


Los controles estándar para formularios Windows, como el PictureBox, ya 
incorporan esta técnica y además la tienen activada, por lo que no tenemos que 
escribir código extra. En el caso de utilizar un formulario para presentar la suce- 
sión de imágenes, este incorpora la técnica de doble búfer, pero no la tiene activa- 
da, por lo que si queremos utilizarla hay que escribir código extra. 


Para habilitar el doble búfer en formularios, así como en otros controles que 
puedan incorporarlo, hay que asignar a su propiedad DoubleBuffered el valor 
true, o bien utilizar el método SetStyle. 


Como ejemplo puede realizar el ejercicio 2, pero haciendo rodar la bola sobre 
el formulario en lugar de sobre un PictureBox. Puede ver el código de este ejerci- 
cio en la carpeta Cap08\Resueltos\DobleBúfer del CD que acompaña al libro. 
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4. Sonido. El espacio de nombres System.Media contiene clases para escuchar fi- 
cheros de sonido, así como para acceder a los sonidos proporcionados por el sis- 
tema. Estas clases son las siguientes: 


e SoundPlayer. Permite cargar y escuchar ficheros de sonido en varios forma- 
tos, así como ficheros .wav en segundo plano. 


e SystemSound. Clase que representa un sonido de los proporcionados por el 
sistema. 


e SystemSounds. Permite recuperar sonidos asociados con el sistema. Propor- 
ciona una serie de propiedades para acceder a sonidos predefinidos, como As- 
terisk, Beep, Exclamation, Hand y Question. Cada una de estas propiedades 
devuelve un objeto SystemSound que se utilizará para escuchar el sonido. 


El siguiente ejemplo muestra cómo reproducir el sonido "beep": 


// Reproducir el sonido Beep del sistema 
SystemSounds.Beep.Play(); 


También se puede reproducir el sonido “beep” por medio del método Beep de 
la clase Console: 


Console.Beep(); 


Este otro ejemplo muestra cómo reproducir un fichero de sonido: 


// Reproducir el fichero sonido.wav de forma asíncrona 
reproductor = new SoundPlayer(); 
reproductor .SoundLocation = "..\\.. \\Sonidos\\sonido.wav"; 
reproductor.LoadAsync(); 
if (reproductor.IsLoadCompleted) 

reproductor.Play(); 


El método Play reproduce el fichero cargado por reproductor de forma asin- 
crona (lanza un hilo y vuelve). PlaySynce lo haría de forma sincrona. Para cargar 
el fichero a reproducir se pueden utilizar los métodos Load (carga síncrona) o 
LoadAsync (carga asíncrona). No obstante, un intento de reproducir un fichero 
que aún no ha sido cargado, cargaría el fichero y después se reproduciría. Así 
mismo, un fichero reproducido no necesitará volverse a cargar para reproducirse 
otra vez mientras la ruta no cambie. 


Como ejemplo vamos a poner sonido a la aplicación calculadora que hicimos 
en el capítulo 3. Para ello, lo primero que hay que hacer es crear los ficheros .wav 
necesarios utilizando los recursos de la tarjeta de sonido. El ejemplo va a consistir 
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en añadir sonido a esa calculadora de forma que al hacer clic en cualquiera de las 
teclas de la misma, se reproduzca el sonido correspondiente a la tecla pulsada. 


Para realizar este proceso primero hay que construir un fichero .wav por cada 
tecla; esto es, uno.wav con el sonido “uno”, dos.wav con el sonido “dos”, etc. El 
paso siguiente es añadir el método Play en los métodos que se ejecutan cuando se 
pulsa cada una de las teclas, para que se ejecute el fichero de sonido correspon- 
diente a la tecla pulsada. Por ejemplo, la siguiente línea reproduciría “uno”: 


reproductor = new SoundPlayer(); 
reproductor .SoundLocation = "..1X..1ASonidosiAsonido.wav"; 
reproductor.Play():; 


Puede ver el código de este ejercicio en la carpeta Cap08 Resueltos Calcula- 
dora del CD que acompaña al libro. 


EJERCICIOS PROPUESTOS 


1. Tablero de dibujo. Vamos a desarrollar una aplicación que se comporte como un 
tablero de dibujo. Dicha aplicación mostrará una ventana con una barra de menús, 
una barra de herramientas, una barra de estado para mostrar los valores X, Y co- 
rrespondientes a las coordenadas de la posición actual del puntero del ratón y un 
panel que hará de superficie de dibujo con su cursor particularizado. 





Archivo Dibujar Ayuda 


[4]- no 





X: 457 Y:149 


La barra de menús tiene los menús Archivo, Dibujar y Ayuda. El menú Archi- 
vo consta de dos órdenes: Nuevo y Salir. La orden Nuevo limpia la pantalla para 
iniciar un nuevo dibujo, y la orden Salir finaliza una sesión de trabajo. El menú 
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Dibujar tiene una orden por cada herramienta de dibujo que a continuación des- 
cribimos. Y el menú Ayuda consta de dos órdenes: Instrucciones..., y Acerca de. 
La orden Instrucciones... visualiza un diálogo que presenta las instrucciones para 
manejar el tablero de dibujo, y la orden Acerca de visualiza una caja de diálogo 
con los créditos de la aplicación. 


La caja de herramientas consta de las herramientas dibujar a mano alzada, di- 
bujar líneas, dibujar rectángulos o cuadrados y dibujar elipses o círculos. Se po- 
drían haber añadido otras como dibujar rectángulos o cuadrados coloreados, 
dibujar elipses o circulos coloreados, rellenar un área de color, escribir texto o 
elegir un color, pero esto y más resultará sencillo una vez realizado lo propuesto. 
El cursor del ratón será una cruz sobre el área de cliente y una flecha fuera de ella. 


Para dibujar a mano alzada, primero haga clic sobre esta herramienta. A con- 
tinuación, sitúe el cursor en la posición del área de cliente donde desea comenzar 
a dibujar y pulse el botón izquierdo del ratón; con este botón pulsado, arrastre en 
la dirección deseada. Para finalizar, suelte el botón. 


Para dibujar líneas, primero haga clic sobre esta herramienta. A continuación, 
sitúe el cursor en la posición del área de cliente donde desea que comience la lí- 
nea, pulse el botón izquierdo del ratón y con él pulsado mueva el ratón en la di- 
rección deseada hasta dejar la línea con la longitud e inclinación requeridas. Para 
finalizar, suelte el botón. 


Para dibujar rectángulos, primero haga clic sobre esta herramienta. A conti- 
nuación, sitúe el cursor en la posición del área de cliente donde desea situar la es- 
quina superior izquierda de la caja, pulse el botón izquierdo del ratón y con él 
pulsado mueva el ratón en la dirección deseada hasta dibujar la caja. 


Para dibujar círculos o elipses, primero haga clic sobre esta herramienta. A 
continuación, sitúe el cursor en la posición del área de cliente donde desea situar 
la elipse o el círculo, pulse el botón izquierdo del ratón y con él pulsado mueva el 
ratón en la dirección deseada hasta dibujar la elipse. 


Inicialmente, la utilidad por omisión es la de dibujar a mano alzada. Poste- 
riormente, la elección de cualquier otra herramienta cancela la anteriormente se- 
leccionada. Si hace clic sobre el botón que está pulsado, no se ejecutará ninguna 
acción. 


Según lo expuesto en el apartado sobre Gráficos persistentes, la técnica de co- 
locar los gráficos en el controlador del evento Paint no es viable en este caso por- 
que no se puede prever lo que el usuario va a dibujar, por lo que habrá que crear 
una superficie de dibujo permanente y dibujar los gráficos sobre ella. Cualquier 
cosa que se dibuje en el objeto Graphics devuelto por CreateGraphics no es 
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permanente y se ignorará cuando se refresque el área de dibujo, y lo que se dibuje 
en un objeto Graphics basado en un mapa de bits es permanente y se refresca 
adecuadamente siempre que sea necesario. 


La solución que se sugiere para el problema propuesto es combinar las dos 
técnicas y dibujar formas que son permanentes y formas que no lo son. Para las 
formas no permanentes se utilizará el controlador del evento Paint y las formas 
permanentes se dibujarán directamente sobre una superficie permanente que se 
creará para tal fin. Por ejemplo, cuando se dibuje un rectángulo, todas las formas 
intermedias que se dibujan mientras se arrastra con el ratón serán no permanentes 
y la forma final, cuando se suelta el botón del ratón, será permanente. El dibujo a 
mano alzada es una excepción a la regla anterior; en este caso dibujaremos desde 
el controlador del evento Paint, pero sobre la superficie permanente. 


Representación de funciones. Modificar el ejercicio 1 del apartado Ejercicios re- 
sueltos para que cuando se pinte el cursor se repinte solo el rectángulo mínimo que 
exige este proceso y no toda la superficie gráfica. En este caso, para ejecutar el 
método ciFuncion Paint, ciFuncion MouseMove invocará al método Invalidate 
pasándole como argumento el rectángulo de la superficie de dibujo que hay que 
repintar. 


CAPÍTULO 9 


O F.J.Ceballos/RA-MA 


INTERFAZ PARA MÚLTIPLES 
DOCUMENTOS 


Si ya ha trabajado con distintas aplicaciones Windows, habrá notado que hay va- 
rios estilos de interfaz de usuario: la interfaz de documento único (SDI - Single 
Document Interface), la interfaz de documentos múltiples (MDI - Multiple Docu- 
ment Interface) y la interfaz estilo explorador. Hasta ahora en este libro hemos 
utilizado casi exclusivamente el estilo SDI. La interfaz de múltiples documentos 
fue diseñada para simplificar el intercambio de información entre documentos de- 
pendientes todos de una misma aplicación. Así, en lugar de tener múltiples copias 
abiertas de la misma aplicación, tendremos una sola copia y múltiples ventanas de 
documentos abiertas. Un ejemplo de aplicación con una interfaz MDI es la hoja 
de cálculo Microsoft Excel. 
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Cuando se ejecuta una aplicación MDI aparece en primer lugar una ventana 
de aplicación (ventana padre), la cual proporciona un espacio de trabajo para to- 
das las ventanas de documento que se creen (ventanas hija). De esta forma, el 
usuario puede trabajar con varios documentos a la vez, cada uno en su propia ven- 
tana, entendiendo por documento un conjunto de datos (texto, imágenes, etc.). 


Las ventanas de documento pueden crearse para que contengan diferentes ti- 
pos de información; esto es, una ventana puede mostrar un documento de texto y 
otra un documento gráfico. Un ejemplo de lo que estamos diciendo es la aplica- 
ción Microsoft Excel, que permite crear y mostrar varias ventanas de documento 
de diferentes tipos. 


Una ventana de aplicación es un formulario normal cuya propiedad IsMDI- 
Container tiene asignado el valor true, y una ventana de documento es un formu- 
lario normal cuya propiedad MdiParent tiene asignada una referencia a su 
ventana padre (por ejemplo, this). Por lo tanto, tratándose de formularios norma- 
les, es fácil comprender lo que decíamos antes respecto a que una aplicación po- 
día incluir varias ventanas de documento de tipos similares o diferentes. 


CREACIÓN DE UNA APLICACIÓN MDI 


En Visual C#, una aplicación MDI consta de un único formulario padre y de un 
número variable de formularios hijo contenidos en el espacio de trabajo del for- 
mulario padre. 


Para crear una aplicación MDI, inicie Visual Studio y siga los pasos indicados 
a continuación: 


1. Cree una aplicación para Windows: Archivo > Nuevo proyecto > Aplicación 
de Windows Forms. Asigne a la aplicación el nombre 4ApWindowsMDI y al 
formulario FormPadre. 


2. Seleccione FormPadre, diríjase a la ventana propiedades y asigne a su pro- 
piedad IsMDIContainer el valor true. Esto hace que este formulario pase a 
ser un contenedor MDI para formularios hijo. 


Opcionalmente, puede asignar a la propiedad WindowState el valor Maximi- 
zed, lo que permitirá manipular los formularios hijo más fácilmente. 


3. Desde la caja de herramientas, arrastre sobre el formulario padre una barra de 
menús: control MenuStrip. Denomínela BarraMenusFormPadre. Asegúrese 
de que la propiedad MainMenusStrip del formulario hace referencia a esta 
barra de menús; esta propiedad no era relevante para las aplicaciones SDI, pe- 
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ro sí para las MDI. Añada a la barra de menús un menú Archivo, identificado 
por menuArchivo, con los elementos Nuevo y Cerrar, identificados por Archi- 
voNuevo y ArchivoCerrar, respectivamente. Añada también otro menú deno- 
minado Ventana, identificado por menuVentana. 


El menú Archivo creará y cerrará los formularios hijo durante la ejecución, 
mientras que el menú Ventana se encargará del seguimiento de los formula- 
rios hijo abiertos. Seleccione la barra de menús y asigne a su propiedad 
MdiWindowListltem el valor menuVentana, lo que permitirá que este menú 
visualice la lista de formularios hijo abiertos. 


Llegados a este punto tenemos el formulario padre creado. El siguiente paso 


es crear los formularios hijo. Esto supone añadir un nuevo formulario y diseñarlo 
en función de la actividad que deseamos desarrolle el formulario hijo. Después, 
crear formularios hijo durante la ejecución de la aplicación supondrá crear objetos 
de la clase de este formulario y visualizarlos. Según lo expuesto: 


1. 


En el explorador de soluciones, haga clic con el botón secundario del ratón en 
el proyecto, y ejecute Agregar > Nuevo elemento > Windows Forms. Este 
formulario será la plantilla de los formularios hijo. Denominelo FormHijo. 


Desde la caja de herramientas, arrastre sobre el formulario hijo una barra de 
menús: control MenuStrip. Denomínela BarraMenusFormHijo. Añada a la 
barra de menús un menú Edición, identificado por menuEdicion, con los ele- 
mentos Cortar, Copiar y Pegar, identificados por EdicionCortar, EdicionCo- 
piar y EdicionPegar, respectivamente. 


La propiedad AllowMerge de las barras de menús de los formularios padre e 
hijo deben tener el valor true, lo que permitirá la fusión de ambas barras en 
una sola que será mostrada por el formulario padre. También debe poner la 
propiedad Visible de la barra de menús del formulario hijo a false. 


¿Cómo se combinan los menús de ambas barras? Esto depende de las propie- 
dades Mergelndex y MergeAction de los menús. La primera propiedad se 
utiliza para obtener/establecer la posición de un elemento dentro de la barra. 
Según esto, asigne a Archivo la posición 0 y a Ventana la 2 (orden natural que 
van a ocupar). Por otra parte, asigne a Mergelndex de Edición la posición 1 y 
a su propiedad MergeAction el valor Insert. Esta última propiedad especifica 
la acción que se realizará. En nuestro caso, la acción es Insert; esto es, insertar 
el elemento en el lugar especificado (si las posiciones coincidieran, la inser- 
ción se realizaría antes del elemento con el que coincide). 


Arrastre también desde la caja de herramientas un control RichTextBox y 
asigne a su propiedad Anchor el valor Top, Left y a su propiedad Dock el va- 
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lor Fill. Esto hace que el control RichTextBox llene por completo el área del 
formulario, independientemente del tamaño del mismo. 


3. Cree un controlador de eventos Click para el elemento Nuevo de Archivo y 
edítelo como se indica a continuación. Observe que la acción llevada a cabo 
por este controlador es crear un nuevo formulario hijo (objeto de la clase 
FormHijo) y visualizarlo. 


private void ArchivoNuevo_Click(object sender, EventArgs e) 
( 
FormHijo NuevoFormHijo; 
// Crear un nuevo formulario hijo 
uevoFormHijo = new FormHijo(); 
// Título del formulario hijo 





uevoFormHijo.Text = "Form " + MdiChildren.Length.ToString():; 
// Establecer el formulario padre del hijo 
uevoFormHijo.MdiParent = this; 











// Mostrar el formulario hijo 
uevoFormHijo.Show():; 











} 


Ejecute la aplicación y pruebe los resultados. Obsérvese cómo el menú Ven- 
tana muestra los títulos de los formularios hijo creados. La propiedad MdiChil- 
dren representa la matriz de tipo Form que identifica a los formularios hijo del 
formulario padre. 


Durante la ejecución, todos los formularios hijo se muestran dentro del área 
de trabajo del formulario padre. Cuando se minimiza un formulario hijo, su icono 
aparece en el fondo del formulario padre en lugar de aparecer en la barra de ta- 
reas, y cuando se maximiza, su título se combina con el título del formulario pa- 
dre visualizándose ambos en la barra de título del mismo. También, cuando se 
visualice un formulario hijo que tenga su propia barra de menús, el formulario pa- 
dre visualizará esta barra combinada con la suya. El formulario padre visualizará 
su barra de menús solo cuando no haya ningún formulario hijo presente. 


La finalidad del elemento Cerrar de Archivo es cerrar el formulario activo. 
¿Cómo se sabe cuál es el formulario activo? Esta información nos la proporciona- 
rá el formulario padre a través de su propiedad ActiveMdiChild. Según esto, po- 
demos escribir el controlador para el evento Click de Cerrar así: 


private void ArchivoCerrar_Click(object sender, EventArgs e) 
( 

FormHijo FormHijoActivo = (FormHijo)ActiveMdiChild; 

if (FormHijoActivo != null) FormHijoActivo.Close(); 
) 
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Organizar los formularios hijo 


Normalmente, todas las aplicaciones MDI del entorno de Windows tienen un me- 
nú llamado Ventana que contiene dos grupos de elementos: uno para organizar los 
formularios hijo abiertos y otro para exponer los títulos de los mismos; este últi- 
mo grupo, vimos que es implementado automáticamente a través de la propiedad 
MdiWindowListltem. Por lo tanto, solo nos queda por implementar el primero 
según muestra la figura siguiente: 


Ventana 
Cascada | 
Horizontal X 
Vertical 











1 Form 0 


2 Form 1 


3 Form 2 





Añada los elementos Cascada, Horizontal y Vertical al menú ventana y des- 
pués escriba sus controladores como se indica a continuación: 


private void VentanaCascada_Click(object sender, EventArgs e) 
( 
LayoutMdi(MdiLayout.Cascade); 


1 
$ 


private void VentanaHorizontal_Click(object sender, EventArgs e) 
( 

LayoutMdi(MdiLayout.TileHorizontal); 
) 


private void VentanaVertical_Click(object sender, EventArgs e) 
( 








LayoutMdi(MdiLayout.TileVertical); 
) 


El método LayoutMdi permite organizar los formularios hijo en un formula- 
rio padre MDI. La forma en la que los organiza depende del valor pasado como 
argumento, que será uno de los valores de la enumeración MdiLayout: Cascade 
(formularios en cascada), TileHorizontal (formularios organizados en mosaico ho- 
rizontal), TileVertical (formularios organizados en mosaico vertical) o Arrangel- 
cons (organizar los iconos de los formularios). 
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EDITOR DE TEXTO MDI 


Una aplicación MDI típica es un editor de texto capaz de tener varios documentos 
abiertos simultáneamente; de ahí, el nombre de “interfaz de múltiples documen- 
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tos”. 

Según lo que hemos expuesto hasta ahora, para crear en Visual C# una apli- 
cación de este tipo, necesitamos al menos dos formularios, un formulario MDI 
(formulario padre) y un formulario hijo, que crearemos durante el diseño. Des- 
pués, durante la ejecución, podremos crear cuantos ejemplares necesitemos de es- 
te diseño de formulario hijo. 


ag Editor MDI lol E 


Archivo Edición Ver Ventana Ayuda 
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Formulario padre 


Empiece por crear un nuevo proyecto. Después, siguiendo los pasos descritos en 
el apartado anterior, haga que el formulario añadido sea un formulario MDI (pro- 
piedad IsMdiContainer a valor true) y asígnele el título Editor MDI. Cambie su 
propiedad Name y asígnele el valor FormMDI. 


A continuación vamos a colocar en FormMDI una barra de menús denomina- 
da BarraDeMenus, una barra de herramientas denominada BarraDeHerraMdiPa- 
dre y una barra de estado denominada BarraDeEstado. 


La barra de menús contendrá los menús típicos de las operaciones que puede 
realizar el formulario padre: 
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e Archivo, con las órdenes Nuevo, Abrir y Salir. La orden Nuevo permite crear 
un nuevo documento vacío y la orden Abrir cargar un documento existente. 


e Ver, con las órdenes Barra de herramientas y Barra de estado. 


e Ventana, con las órdenes Cascada, Mosaico horizontal, Mosaico vertical y 
Organizar iconos. 


e Ayuda, con la orden Acerca de. 


La barra de herramientas, control ToolStrip, contendrá los botones Nuevo, 
Abrir, separador y Ayuda. Cuando finalice su diseño obtendrá una barra como la 
de la figura siguiente. Los botones estándar los puede insertar ejecutando la orden 
Insertar elementos estándar de la lista de tareas de la barra y eliminando, a conti- 
nuación, los que no necesite. 


a 


Archivo Ver Ventana Ayuda 














Para combinar esta barra de menús con la que aporten los formularios hijo, 
asigne a la propiedad Mergelndex de los menús los valores 0, 2, 3, etc., corres- 
pondientes a la posición que van a ocupar. Haga lo mismo con los elementos del 
menú Archivo, ya que la barra de menús del formulario hijo aportará su propio 
menú Archivo. Por la misma razón, asigne también el valor 0 a la propiedad Mer- 
gelndex del botón Nuevo y 1 a la del botón Abrir de la barra de herramientas. 


Finalmente, añada a la barra de estado una etiqueta (objeto ToolStripStatus- 
Label) denominada etbarestPpal y asigne a su propiedad Text el valor “Listo”. 


Con el trabajo realizado hasta ahora concluye el diseño del formulario padre 
(formulario MDI). 
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Ahora puede añadir la caja de diálogo Acerca de, según se explicó en el apar- 
tado Diálogo acerca de del capitulo Controles y cajas de diálogo, y una pantalla 
de presentación, según se explicó en el apartado Pantalla de presentación del ca- 
pítulo Aplicación Windows Forms. 


Formulario hijo 


Continuamos la construcción de la aplicación con el diseño del formulario hijo. 
Añada un nuevo formulario; modifique su nombre Form2 para que sea FormDo- 
cumento. 


A continuación vamos a colocar en FormDocumento una barra de menús típi- 
ca de un procesador de textos, una barra de herramientas y un control RichText- 


Box, denominado ríbText, que actuará como soporte del documento. 


La barra de menús contendrá los menús con los elementos especificados a 
continuación (estos se sumarán a los de la ventana padre): 


e Archivo, con las órdenes Guardar, Guardar como, Imprimir y separador. 


e Edición, con las órdenes Deshacer y Rehacer, separador, Cortar, Copiar y 
Pegar. 





a) Form2 ola es 
Edición 


Guardar XK S 
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Imprimir 











La barra de herramientas, control ToolStrip que denominaremos BarraDeHe- 
rraMdiHija, contendrá los botones Guardar, Imprimir, separador, Cortar, Copiar, 
Pegar, separador, Negrita, Cursiva, Subrayado, separador, Alinear a la izquierda, 
Centrar y Alinear a la derecha (estos se sumarán a los de la ventana padre). 
Cuando finalice su diseño obtendrá una barra como la de la figura siguiente. Los 
botones estándar los puede insertar ejecutando la orden Insertar elementos están- 
dar de la lista de tareas de la barra, eliminando a continuación los que no necesite. 
El resto de los botones tendrá que añadirlos usted mismo. 
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Asigne a la propiedad Visible de la barra de menús y de la barra de herra- 
mientas de este formulario el valor false. 


Recuerde que la barra de menús del formulario hijo activo se combinará con 
la barra del formulario padre. Esta combinación se hará en función de las propie- 
dades Mergelndex y MergeAction de los menús, de las barras y de los elementos 
de los menús del mismo nombre. Según esto, asigne a la propiedad Mergelndex 
de Archivo y Edición los valores 0 y 1 respectivamente, y a su propiedad Mer- 
geAction los valores MatchOnly e Insert, respectivamente. 


MatchOnly permitirá que los menús Archivo de los formularios padre e hijo 
se fusionen de acuerdo a los valores de Mergelndex y MergeAction de sus ele- 
mentos. Por lo tanto, asigne a la propiedad Mergelndex de los elementos de Ar- 
chivo los valores 2, 3, 4 y 5 (incluido el separador), y a su propiedad MergeAc- 
tion, el valor Insert, El resultado será el siguiente: 
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Obsérvese en el menú Archivo de la figura anterior que las órdenes Nuevo, 
Abrir y Salir proceden del formulario padre y el resto del formulario hijo. Obsér- 
vese también el orden de los menús de la barra de menús. 


Siga un proceso análogo para fusionar los botones de las barras de herramien- 
tas, asignándoles el índice correspondiente a la posición que van a ocupar y, ade- 
más, en la barra de herramientas del formulario hijo, la acción a ejecutar. Ahora 
bien, solo las barras de menús participan en la fusión automática. La fusión de las 
barras de herramientas y barras de estado requiere una programación explícita- 
mente. Esto es, utilice el método Merge para fusionarlas y RevertMerge para 
deshacer la operación de fusión, ambos de la clase ToolStripManager. El lugar 
más apropiado para realizar estas operaciones es el manejador del evento Mdi- 
ChildActivate. Este evento se produce cuando un formulario MDI hijo se activa 
(porque se crea o porque se cambió a otro formulario) o se cierra (se activa el úl- 
timo creado, si lo hay) dentro de una aplicación MDI. Piense que los formularios 
hijo no necesariamente tienen que ser todos iguales. Por eso, cada vez que se acti- 
va un formulario hijo, se quita la barra de herramientas del que deja de ser activo 
y se fusiona la del que pasa a estar activo. 
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private void FormMDI_MdiChildActivate(object sender, EventArgs e) 
( 
// Eliminar cualquier fusión previa 
ToolStripManager.RevertMerge(this.BarraDeHerraMdiPadre); 
// Ventana hija activa 
FormDocumento vHijaAc = (FormDocumento)this.ActiveMdiChild; 
// Realizar la fusión si hay una ventana hija activa 
if (vHijaAce != null) 
ToolStripManager.Merge(vHijaAc.BarraDeHerraMdiHija, 
this.BarraDeHerraMdiPadre); 








El control RichTextBox se utiliza para mostrar, escribir y manipular texto 
con formato. Hace todo lo que realiza el control TextBox y, además, permite 
mostrar fuentes, colores y vínculos, cargar texto e imágenes desde un fichero y 
buscar caracteres especificados. De forma predeterminada muestra tanto una barra 
de desplazamiento horizontal como vertical, según se precise. 


Como sucede con el control TextBox, el texto que muestra el control Rich- 
TextBox se establece con su propiedad Text y, además, tiene otras propiedades 
para dar formato al texto, establecer los atributos de la fuente, establecer sangrías, 
sangrías francesas y párrafos con viñetas, etc. Para manipular ficheros, proporcio- 
na los métodos LoadFile y SaveFile, los cuales admiten ficheros en varios forma- 
tos: texto sin formato, texto codificado en Unicode y formato de texto enriquecido 
(RTF). Así mismo, se puede utilizar el método Find para buscar cadenas de texto 
o caracteres específicos. 


También puede utilizar un control RichTextBox para especificar vínculos de 
estilo web; para ello, establezca la propiedad DetectUrls a true y escriba código 
para controlar el evento LinkClicked. 


Para deshacer y rehacer la mayoría de las operaciones de edición de un con- 
trol RichTextBox, llame a los métodos Undo y Redo. La propiedad CanRedo 
permite determinar si la última operación deshecha por el usuario puede aplicarse 
de nuevo al control y CanUndo si la operación anterior realizada en el control se 
puede deshacer. 


Utilice el portapapeles para realizar las operaciones típicas de cortar, copiar y 
pegar; métodos Cut, Copy y Paste. 


Vincular código con los controles 


Una vez finalizado el diseño, vamos a escribir el código necesario para que la 
aplicación se comporte según el planteamiento realizado. 
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Iniciar y finalizar la aplicación 


Cuando se inicia la aplicación se carga el formulario padre. Para mostrar un for- 
mulario hijo habrá que ejecutar la orden Nuevo o Abrir, o bien hacer clic en el bo- 
tón del mismo nombre de la barra de herramientas. 


Para cerrar la aplicación puede, simplemente, cerrar el formulario padre, o 
bien hacer clic en la orden Salir del menú Archivo. Añada el controlador del even- 
to Click de esta orden y escríbalo como se indica a continuación: 


private void ArchivoSalir_Click(object sender, EventArgs e) 
( 

Close(); 
) 


Nuevo documento 


Cuando se inicie la aplicación y se cargue el formulario MDI, desearemos a con- 
tinuación cargar un documento vacío. Esta operación podremos realizarla desde la 
orden Archivo > Nuevo y desde el botón Nuevo de la barra de herramientas. Por lo 
tanto, los eventos Click de ambos ejecutarán el mismo controlador. Añada este 
controlador y escríbalo como se indica a continuación: 


private void ArchivoNuevo_Click(object sender, EventArgs e) 
( 
FormDocumento NuevoFormHijo; 
// Crear un nuevo formulario hijo 

uevoFormHijo = new FormDocumento():; 

// Título del formulario hijo 

uevoFormHijo.Text = "Documento " + MdiChildren.Length.ToString(); 
// Establecer el formulario padre del hijo 

uevoFormHijo.MdiParent = this; 

// Mostrar el formulario hijo 

uevoFormHijo.Show():; 
































Este método crea un nuevo formulario de la clase FormDocumento, le asigna 
el título “Documento n”, donde n se corresponde con el número de elementos de 
la matriz MdiChildren de formularios hijo, le asigna una referencia a su formula- 
rio padre y lo visualiza invocando al método Show. 


Como hemos dicho anteriormente, el botón Nuevo de la barra de herramientas 
tiene que ejecutar este mismo método. Por lo tanto, seleccione el botón, diríjase a 
la ventana de propiedades, muestre el panel de eventos, seleccione el evento Click 
y asígnele el controlador ArchivoNuevo_Click que acabamos de añadir. 
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Abrir un documento 


Cuando el usuario haga clic en la orden Abrir del menú Archivo o pulse el botón 
Abrir de la barra de herramientas, tiene que visualizarse la caja de diálogo están- 
dar Abrir. En ella, el usuario elegirá el fichero que quiere visualizar con formato 
txt o rtf. El fichero seleccionado se visualizará sobre el formulario activo. Si no 
hubiera un formulario activo, entonces se creará uno nuevo. También, cambiare- 
mos el título del formulario para que coincida con el nombre del fichero seleccio- 
nado, mostraremos en la barra de estado la ruta completa del fichero y 
asignaremos a la propiedad Modified del control RichTextBox el valor false para 
dejar constancia de que el fichero aún no ha sido modificado. Esta propiedad 
cambiará automáticamente a true cuando el fichero se modifique. 


Como la orden Abrir pertenece al menú Archivo del formulario FormMDI, 
tiene que añadir el controlador para el evento Click de esta orden: 


private void ArchivoAbrir_Click(object sender, EventArgs e) 
( 
// Formulario hijo activo 
FormDocumento FormHijo = (FormDocumento)ActiveMdiChild; 


// Si no hay ningún formulario hijo creado, crear uno 
// ejecutando el método ArchivoNuevo_C lick 

if (FormHijo == null) 

( 





ArchivoNuevo.PerformClick(); 
FormHijo = (FormDocumento)ActiveMdiChild; 





) 





// Mostrar el diálogo Abrir 

OpenFileDialog DIgAbrir = new OpenFileDialog(); 

DlgAbrir.Filter = 
"ficheros txt (*.txt)|*.txt|ficheros rtf (*.rtf)|*.rtf"; 

if (DIgAbrir.ShowDialog() == DialogResult.0K) 

( 
// Obtener el nombre del fichero 
string ruta = DIgAbrir.FileName; 
// Obtener el formato del fichero 

RichTextBoxStreamlype formato = 

RichTextBoxStreamlype.PlainText; 

if (DlgAbrir.FilterIndex == 2) 
formato = RichTextBoxStreamlype.RichText; 

// Cargar el fichero 

FormHijo.rtbText.LoadFile(ruta, formato); 

// Mostrar el nombre del fichero en la barra de título 

FormHijo.Text = ruta.Substringí(ruta.lLastIindex0f("A1") + 1); 

// Mostrar la ruta del fichero en la barra de estado 

this.etbarestPpal.Text = ruta; 
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// Aún no ha sido modificado 
FormHijo.rtbText.Modified = false; 
) 
) 


El botón Abrir de la barra de herramientas tiene que ejecutar este mismo mé- 
todo. Por lo tanto, proceda de forma análoga a como hizo con el botón Nuevo. 


Guardar un documento 


Cuando el usuario edite un documento y seleccione la orden Guardar del menú 
Archivo proporcionada por el formulario hijo, o pulse el botón Guardar de la ba- 
rra de herramientas, se almacenará el contenido del control rtb Text del formulario 
activo en el fichero especificado. El nombre de este fichero será: 


e El especificado en la caja de diálogo común Guardar cuando el fichero es de 
nueva creación; esto es, cuando el título del formulario es “Documento n”. En 
este caso, cuando se guarde el fichero cambiaremos también el título del for- 
mulario para que coincida con el nombre especificado para el fichero, mostra- 
remos en la barra de estado la ruta completa del fichero y asignaremos a la 
propiedad Modified del control RichTextBox el valor false. Además, verifi- 
caremos si el usuario pulsó el botón Cancelar, lo que supone abandonar el 
proceso iniciado. 


e El nombre actual cuando el contenido de rtbText se inició abriendo un fichero 
existente. Este nombre se puede recuperar de la barra de estado. 


Para poder ejecutar las acciones expresadas, añada el controlador de la orden 
Guardar del menú Archivo y del botón Guardar de la barra de herramientas, que 
será el mismo, procediendo de forma análoga a como hicimos con la orden y el 
botón Abrir, pero ahora en el formulario FormDocumento: 


private void ArchivoGuardar_Click(object sender, EventArgs e) 
( 
// Formulario padre 
FormMDI formPadre = (FormMDI)this.MdiParent; 


// Formulario hijo activo 
FormDocumento FormHijo = this; 
if (FormHijo == null) return; 








// Si el texto cambió... 
if (FormHijo.rtbText.Modified) 











// Obtener la ruta actual del fichero 
string ruta = formPadre.etbarestPpal.Text; 
// Obtener el formato actual del fichero 
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Obsérvese que si el documento no es nuevo, se guarda con el mismo nombre. 


Guardar como 


Esta orden permitirá cambiar el nombre del fichero que se está actualmente edi- 
tando. El controlador de esta orden es muy parecido al de la orden Guardar con la 
diferencia de que aquí siempre se preguntará por el nombre del fichero donde se 
guardará el contenido del control rtbText con el fin de poder cambiarlo. 


private void ArchivoGuardarcomo_Click(object sender, EventArgs e) 


( 


// Formulario padre 


FormMDI formPadre 


(FormMDI)this.MdiParent:; 
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// Formulario hijo activo 
FormDocumento FormHijo = this; 
if (FormHijo == null) return; 


// Mostrar el diálogo Guardar 

SaveFileDialog DlgGuardar = new SaveFileDialog(); 

DlgGuardar.Filter = 
"ficheros txt (*.txt)|]*.txt|ficheros rtf (*.rtf)|*.rtf"; 

if (DlgGuardar.ShowDialog() == DialogResult.OK) 

( 








// Obtener el nombre del fichero 
string ruta = DlgGuardar.FileName; 
// Obtener el formato del fichero 
RichTextBoxStreamlype formato = RichTextBoxStreamlype.PlainText; 
if (DlgGuardar.FilterIndex == 2) 

formato = RichTextBoxStreamlype.RichText; 
// Guardar el fichero 
FormHijo.rtbText.SaveFile(ruta, formato); 
// Mostrar el nombre del fichero en la barra de título 
FormHijo.Text = ruta.Substringí(ruta.lastlIndex0f("11") + 1); 
// Mostrar la ruta del fichero en la barra de estado 
formPadre.etbarestPpal.Text = ruta; 
// Fichero no modificado 


FormHijo.rtbText.Modified = false; 
































) 
) 


Imprimir un documento 


Cuando el usuario edite un documento y seleccione la orden Imprimir del menú 
Archivo o pulse el botón Imprimir de la barra de herramientas, se imprimirá el 
contenido del control rtbText del formulario activo en la impresora seleccionada 
en la caja de diálogo estándar Imprimir. Además, verificaremos si el usuario pulsó 
el botón Cancelar, lo que supone no realizar la impresión. 


Para poder ejecutar las acciones expresadas, sitúese en la ventana de diseño 
del formulario hijo y arrastre desde la caja de herramientas un control PrintDia- 
log, denominado PrintDialogl, y otro PrintDocument, denominado PrintDocu- 
mentl (véase también en el capítulo Construcción de controles, el apartado 
Ejercicios propuestos). 


Asigne a la propiedad Document de PrintDialogl el objeto PrintDocumentl 
que vamos a utilizar para imprimir. Verifique también que la propiedad 
UseEXDialog vale true. 


Defina las variables línea de tipo string y totalLineasImpresas de tipo Inte- 
ger como atributos privados de la clase FormDocumento: 
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private string[l] línea; 
private int totallineasImpresas; 


Añada el controlador de la orden Imprimir del menú Archivo y del botón Im- 
primir de la barra de herramientas, que será el mismo, procediendo de forma 
análoga a como hicimos, por ejemplo, con la orden y el botón Abrir. Este contro- 
lador mostrará el diálogo Imprimir para permitir al usuario seleccionar la impreso- 
ra y, a continuación, recupera el texto del control RichTextBox, almacena cada 
una de las líneas que lo componen en la matriz línea, inicia la variable totalLi- 
neasImpresas a cero e invoca al método Print para imprimir el contenido de /í- 
nea. 


private void Archivolmprimir_Click(object sender, EventArgs e) 
( 
// Formulario padre 
FormMDI formPadre = (FormMDI>)this.MdiParent; 


// Formulario hijo activo 
FormDocumento FormHijo = this; 
if (FormHijo == null) return; 











// Permitir al usuario elegir el rango de páginas a imprimir. 
PrintDialogl1.AllowSomePages = true; 
if (PrintDialogl1.ShowDialog() == DialogResult.0K) 
( 
// Si se pulsó el botón "Aceptar" (0K), entonces imprimir. 
string texto = FormHijo.rtbText.Text; 
char[] seps = [ 'An”, *Ar* }; // LF y CR 
línea = texto.Split(seps); // líneas de texto que hay que imprimir 
totallineasImpresas = 0; 
PrintDocument1l.Print(); //invoca a ImprimirDoc_PrintPage 








El método Print produce el evento PrintPage que tendremos que controlar 
para programar la impresión. Por lo tanto, asigne al evento PrintPage de Print- 
Documentl el controlador ImprimirDoc_PrintPage. Después, edítelo como se in- 
dica a continuación. Este controlador, en primer lugar, calcula el número de líneas 
que se pueden imprimir en cada página y, a continuación, las imprime. Cada vez 
que se llena una página, salta a una nueva solo si quedan aún líneas por imprimir. 


private void PrintDocumentl_PrintPage(object sender, 
System.Drawing.Printing.PrintPageEventArgs e) 
( 

// Formulario padre 

FormMDI formPadre = (FormMDI>)this.MdiParent; 


// Formulario hijo activo 
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FormDocumento FormHijo = this; 


// Insertar aquí el código para procesar la página. 
float lineasPorPag; 

float pos_Y; 

float margenlzq = e.MarginBounds.Left; 

float margenSup = e.MarginBounds.Top; 





// Calcular el número de líneas por página 

Font fuente = FormHijo.rtbText.Font; 

float altoFuente = fuente.GetHeight(e.Graphics):; 
lineasPorPag = e.MarginBounds.Height / altoFuente; 





// Contador de las líneas impresas en una página 
int lineasImpresasPorPag = 0; 


// Imprimir cada una de las líneas 

while (totallineasImpresas < línea.Length 22 

lineasImpresasPorPag < lineasPorPag) 

( 
pos_Y = margenSup + (lineasImpresasPorPag * altoFuente); 
e.Graphics.DrawString(línea[totallineasImpresas], fuente, 

Brushes.Black, margenlzq, pos_Y, new StringFormat()); 

lineasImpresasPorPag += 1; 

totallineasImpresas += 1; 


) 


// Si quedan líneas por imprimir, siguiente página 
if (totallineasImpresas < línea.Length) 
e.HasMorePages = true; // se invoca de nuevo a ImprimirDoc_PrintPage 
else 
e.HasMorePages = false; // finaliza la impresión 








Obsérvese que cuando hay que imprimir una página adicional, se asigna a la 
propiedad HasMorePages el valor true. Cuando esta propiedad vale true, se in- 
voca automáticamente de nuevo al controlador del evento PrintPage; si vale fal- 
se, se finaliza la ejecución del controlador dando por terminada la impresión. 


Cortar, copiar y pegar 


Cuando el usuario edite un documento y seleccione alguna parte del texto del con- 
trol rtbText del formulario activo, podrá cortarla o copiarla para pegarla en otra 
parte del documento o en otro documento. Para obtener el texto seleccionado he- 
mos utilizado la propiedad SelectedRtf. Esta propiedad, a diferencia de la propie- 
dad SelectedText, obtiene el texto con formato enriquecido. Lógicamente, el 
movimiento del texto se hace a través del objeto Clipboard. 
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private void EdicionCortar_Click(object sender, EventArgs e) 


( 


} 


FormDocumento FormHijo = this; 

// Verificar si hay texto seleccionado 

if (FormHijo.rtbText.SelectedRtf != "") 

{ 
// Cortar el texto seleccionado y ponerlo en la papelera 
FormHijo.rtbText.Cut(); 

) 


private void EdicionCopiar_Click(object sender, EventArgs e) 


( 


} 


FormDocumento FormHijo = this; 

// Verificar si hay texto seleccionado 

if (FormHijo.rtbText.SelectedRtf != "") 

( 
// Copiar el texto seleccionado y ponerlo en la papelera 
FormHijo.rtbText.Copy(); 

) 





private void EdicionPegar_Click(object sender, EventArgs e) 


( 


} 


FormDocumento FormHijo = this; 

// Verificar si hay texto en la papelera para pegar 

if ((Clipboard.GetData0bject().GetDataPresent(DataFormats.Text)) = true) 
( 

// Verificar si hay texto seleccionado 

if (FormHijo.rtbText.SelectionLength > 0) 

( 
// Preguntar al usuario si quiere sobrescribir el texto seleccionado 
if (MessageBox.Show("¿Quiere sobrescribir la selección?”", 

"Pegar", MessageBoxButtons.YesNo) == DialogResult.No) 

( 
// Mover el punto de inserción después de la selección y pegar 
FormHijo.rtbText.SelectionStart = 

FormHijo.rtbText.SelectionStart + 
FormHijo.rtbText.SelectionLength; 








) 
) 
// Pegar el contenido de la papelera 
FormHijo.rtbText.Paste(); 
) 


Recordar las ediciones reversibles 


Para que un componente de texto pueda soportar las operaciones de Deshacer y 
Rehacer debe recordar cada operación de edición que ha tenido lugar, el orden en 
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el que se han sucedido y lo que supone el deshacerlas. Para realizar este trabajo, la 
clase RichTextBox proporciona las propiedades CanUndo y CanRedo, y los mé- 
todos Undo y Redo. 


La propiedad CanUndo devuelve true si hay una operación de edición que se 
puede deshacer y false en caso contrario. El método Undo deshace la última ope- 
ración de edición que fue hecha. 


private void EdicionDeshacer_Click(object sender, EventArgs e) 
( 
FormDocumento FormHijo = this; 


// Verificar si la última operación puede deshacerse 
if (FormHijo.rtbText.CanUndo == true) 


ma 


// Deshacer la última operación 
FormHijo.rtbText.Undo(); 








La propiedad CanRedo devuelve true si hay una operación de edición que se 
puede rehacer y false en caso contrario. El método Redo rehace la última opera- 
ción de edición que fue hecha. 


private void EdicionRehacer_Click(object sender, EventArgs e) 
( 
FormDocumento FormHijo = this; 


// Verificar si la última operación puede rehacerse 
if (FormHijo.rtbText.CanRedo == true) 





// Rehacer la última operación 
FormHijo.rtbText.Redo(); 











Barras de herramientas y de estado 


Cuando el usuario quiera mostrar u ocultar la barra de herramientas o la de estado, 
seleccionará la orden Barra de herramientas o Barra de estado del menú Ver. 
Cuando se lleve a cabo alguna de estas acciones, la orden correspondiente quedará 
señalada o no dependiendo de que la barra esté visible u oculta, respectivamente. 


Supongamos que durante el diseño hemos puesto la propiedad Checked de 
ambas órdenes a true. De esta forma, inicialmente, ambas órdenes aparecerán 
marcadas, indicando así que las barras están visibles. Según esto, podemos escri- 
bir los controladores para estas órdenes así: 
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private void VerBarraDeHerramientas_Click(object sender, EventArgs e) 
( 
VerBarraDeHerramientas.Checked = !VerBarraDeHerramientas.Checked; 
BarraDeHerraMdiPadre.Visible = VerBarraDeHerramientas.Checked; 


} 


private void VerBarraDeEstado_Click(object sender, EventArgs e) 
{ 
VerBarraDeEstado.Checked = !VerBarraDeEstado.Checked; 
BarraDeEstado. Visible = VerBarraDeEstado.Checked; 
) 


Menú Ventana 


Muchas aplicaciones MDI incorporan un menú Ventana. Este es un menú especial 
que visualiza los títulos de todos los formularios hijo abiertos. Además, normal- 
mente, incorporan otras órdenes como Cascada, Mosaico horizontal, Mosaico 
vertical y Organizar iconos para organizar los formularios hijo. 


Para crear un menú de este tipo tiene que: 


1. Añadir un menú Ventana a la barra de menús del formulario MDI. 


2. Seleccionar la propiedad MdiWindowListltem de la barra de menús y 
asignarle el nombre dado al menú Ventana. 


3. Opcionalmente puede añadir otras órdenes como Cascada, Mosaico hori- 
zontal, Mosaico vertical y Organizar iconos. 


Para disponer de los formularios hijo en cascada (solapados), en mosaico (la- 
do a lado) o bien poner los iconos correspondientes a estos formularios ordena- 
damente sobre el formulario padre, utilice el método LayoutMdi del formulario 
MDI. Este método tiene un argumento cuyo valor (Cascade, TileHorizontal, Tile- 
Vertical o Arrangelcons) especifica la operación (cascada, mosaico horizontal, 
mosaico vertical u organizar iconos) que se desea realizar. Las constantes corres- 
pondientes a estas operaciones son definidas por el tipo enumerado MdiLayout. 


El código para cada una de estas órdenes es el siguiente: 


private void Ventanalascada_Click(object sender, EventArgs e) 
( 

LayoutMdi(MdiLayout.Cascade); 
) 


private void VentanaMosaicoHorizontal_Click(object sender, EventArgs e) 
( 

LayoutMdi(MdiLayout.TileHorizontal); 
) 


CAPÍTULO 9: INTERFAZ PARA MÚLTIPLES DOCUMENTOS 363 


private void VentanaMosaicoVertical_Click(object sender, EventArgs e) 


( 
LayoutMdi(MdiLayout.TileVertical); 
) 


private void Ventana0rganizar_Click(object sender, EventArgs e) 
( 

LayoutMdi(MdiLayout.Arrangelcons); 
) 


Selección actual del texto 


La barra de herramientas colocada en el formulario hijo tiene una serie de botones 
relacionados con los formatos de las fuentes y con la alineación de los párrafos. 
Un poco más adelante veremos los procedimientos vinculados con estos botones. 
Ahora lo que queremos hacer es que los botones permanezcan en el estado de pul- 
sado o no en función de las características de la fuente o del párrafo donde está si- 
tuado el punto de inserción. Por ejemplo, si el punto de inserción está sobre un 
carácter en cursiva perteneciente a un párrafo alineado a la izquierda, los botones 
Cursiva y Alinear a la izquierda deberán mostrarse pulsados. Cuando el punto de 
inserción se mueva a otra posición, los botones cambiarán al estado que les co- 
rresponda. 


Para realizar el proceso descrito puede utilizar el evento SelectionChange. 
Este evento permite comprobar las distintas propiedades que proporcionan infor- 
mación acerca de la selección actual (como SelectionFont o SelectionAlign- 
ment) o posición actual del punto de inserción de modo que pueda actualizar los 
botones de una barra de herramientas. Según esto, y de acuerdo a la composición 
de la barra de herramientas de nuestra aplicación, el procedimiento que responda a 
este evento puede ser el siguiente: 


private void rtblext_SelectionChanged(object sender, EventArgs e) 
( 

// Checked = true --> botón pulsado. 

// Checked = false --> botón no pulsado. 

// Negrita, cursiva, subrayado 
btbarNegrita.Checked = rtbText.SelectionFont.Bold; 
btbarCursiva.Checked = rtbText.SelectionFont.Italic; 
btbarSubrayado.Checked = rtbText.SelectionFont.Underline; 


// Alineación del texto 
if (rtbText.SelectionAlignment == HorizontalAlignment.Left) 
btbarAlinIzda.Checked = true; 
else 
btbarAlinlzda.Checked = false; 

(rtbText.SelectionAlignment == HorizontalAlignment.Center) 
btbarAlinCentrada.Checked = true; 








adi 
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else 
btbarAlinCentrada.Checked = false; 

if (rtbText.SelectionAlignment == HorizontalAlignment.Right) 
btbarAlinDcha.Checked = true; 

else 
btbarAlinDcha.Checked = false; 


La propiedad SelectionFont del control RichTextBox obtiene o establece la 
fuente del texto que se aplicará a la selección o al punto de inserción actual. 


Las propiedades Bold, Italic, Strikethru y Underline devuelven el estilo de 
la fuente del texto seleccionado actualmente en un control RichTextBox (negrita, 
cursiva, tachado y subrayado, respectivamente). 


La propiedad SelectionAlignment del control RichTextBox obtiene o esta- 
blece la alineación que se aplicará a la selección o al punto de inserción actual. 


A continuación vamos a programar las acciones que tienen que llevarse a ca- 
bo cada vez que el usuario haga clic sobre alguno de los botones Negrita, Cursiva, 
Subrayado, Alinear a la izquierda, Centrar o Alinear a la derecha, de la barra de 
herramientas. Por ejemplo, empecemos por el botón Negrita. Cuando el usuario 
haga clic en este botón, la selección de texto actual debe ponerse en negrita, y si 
está en negrita, debe volver a normal (regular). Según esto, añada el controlador 
de este botón y edítelo como se muestra a continuación: 


private void btbarNegrita_Click(object sender, EventArgs e) 

( 
// Si Ta selección está en negrita la ponemos en normal y viceversa 
Font fuente = rtblext.SelectionFont; // fuente actual 

if (fuente.Bold) 

fuente = new Font(fuente.FontFamily, fuente.Size, FontStyle.Regular); 

else 

fuente = new Font(fuente.FontFamily, fuente.Size, FontStyle.Bold); 

// Asignar la fuente con el nuevo estilo 

rtbText.SelectionFont = fuente; 

// Asignar true (botón pulsado) o false (botón no pulsado) 

btbarNegrita.Checked = fuente.Bold; 




















Para los estilos Italic y Underline proceda de forma análoga. 


Continuando, añada el controlador del botón Alinear a la izquierda. Cuando 
el usuario haga clic sobre este botón, el párrafo donde actualmente está el punto 
de inserción debe alinearse a la izquierda (Left), el botón debe quedarse pulsado y 
los otros dos botones (Centrar y Alinear a la derecha) deben mostrarse no pulsa- 
dos. Para ello, escríbalo como se muestra a continuación: 
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private void btbarAlinlzda_Click(object sender, EventArgs e) 
( 
rtbText.SelectionAlignment = HorizontalAlignment.Left; 
btbarAlinIzda.Checked = true; 
btbarAlinCentrada.Checked = false; 
btbarAlinDcha.Checked = false; 


Para la alineación centrada (Center) o a la derecha (Right) proceda de forma 
análoga. 


Los cambios de estilo se guardarán en el fichero solo si utiliza el formato rtf. 
El documento ha cambiado 


Cuando el usuario salga de la aplicación, debe tener la oportunidad de guardar su 
trabajo si por despiste no lo ha hecho. Para hacer esto posible, la aplicación nece- 
sita conocer qué documentos han cambiado, lo que se puede hacer interrogando a 
su propiedad Modified. 


La propiedad Modified es particular de cada documento y empieza a ser útil 
cuando el usuario decide cerrar un documento o salir de la aplicación. Esto ocurre 
cuando el usuario ejecuta la orden Cerrar del menú de control de alguno de los 
formularios hijo, cuando ejecuta la orden Cerrar del menú de control del formula- 
rio padre o cuando ejecuta la orden Salir del menú Archivo de la aplicación. 


Cuando el usuario ejecuta la orden Cerrar del menú de control del formulario 
padre, el sistema intenta descargar dicho formulario. Esto hace que se desencade- 
ne, entre otros, el evento FormClosing primero para cada uno de los formularios 
hijo y luego para el formulario padre. Si solo cierra un formulario hijo, entonces 
se desencadenará este evento para este formulario. 


Para el caso que nos ocupa, es suficiente con implementar el controlador de 
este evento para los formularios hijo. Cada vez que se cierre uno de estos formula- 
rios, el controlador del evento FormClosing verificará si el documento ha sido 
modificado y en caso afirmativo, se lo notificará al usuario dándole la oportunidad 
de guardar las modificaciones, de no guardarlas y finalizar, o bien de no guardar- 
las y continuar con la ejecución del documento. Según lo expuesto, este controla- 
dor lo podemos escribir así: 


private void FormDocumento_FormClosing(object sender, FormClosingEventArgs e) 
{ 

// Formulario hijo activo 

FormDocumento FormHijo = this; 

if (FormHijo == null) return; 
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// Si el texto cambió... 
if (FormHijo.rtbText.Modified) 
( 
//Preguntar al usuario si quiere guardar el documento 
DialogResult respuesta; 
respuesta = MessageBox.Show( 
"¿Desea guardar los cambios efectuados en " + 
this.Text + "2", "Editor MDI", 
MessageBoxButtons.YesNoCancel); 
if (respuesta == DialogResult.Yes) 
btbarGuardar.PerformClick(); 
else if (respuesta == DialogResult.No) 
e.Cancel = false; 
else // cancelar 
e.Cancel = true; // evento cancelado 


S1 el código de este procedimiento asigna al parámetro Cancel el valor true, 
el formulario que ha generado el evento no se descargará; en otro caso, sí. 


Operaciones de arrastrar y soltar 


Para que un control RichTextBox admita operaciones de arrastrar y soltar texto, 
imágenes y otros datos, hay que asignar a su propiedad EnableAutoDragDrop el 
valor true. 


Para probar la funcionalidad de arrastrar y colocar en la aplicación, abra el 
editor de texto WordPad de Windows, escriba una o más cadenas de texto en él, 
seleccione el texto y, utilizando el ratón, arrástrelo al control RichTextBox. 
Cuando suelte el botón del ratón, el texto arrastrado se colocará en el control Ri- 
chTextBox. 


EJERCICIOS RESUELTOS 


1. Plantilla de formularios. Vamos a construir un formulario MDI, con una barra de 
menús, que muestre formularios hijo basados en una plantilla de formularios. 


Para empezar, arrancamos Visual Studio y creamos un nuevo proyecto “apli- 
cación para Windows” denominado bodega (esta aplicación tendrá continuidad en 
el capítulo dedicado a las bases de datos). 


La aplicación presenta ahora un formulario. Para hacer de este un formulario 
MDI asigne a su propiedad IsMdiContainer el valor true. A continuación, arras- 
tramos sobre el formulario un control MenuStrip para implementar la barra de 
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menús. Los elementos de esta barra de menús van a ser Nuevo cliente, Realizar 
pedido y Mostrar pedidos. Estos controles nos permitirán navegar entre los dife- 
rentes formularios hijo. Si lo desea, puede personalizar la apariencia de la barra de 
menús añadiendo una imagen, cambiando el tipo de letra, cambiando el fondo, 
etc. 


También puede añadir un panel en el fondo del formulario para que muestre 
su logo; arrastre un control Panel y asigne a su propiedad Dock el valor Bottom 
para que se pegue al fondo. Después, arrastre sobre el panel un control Picture- 
Box y asigne a su propiedad Image la imagen que almacena su logo; para ajustar 
el tamaño de la imagen asigne a la propiedad SizeMode de este control el valor 
StretchImage, y para que la imagen permanezca anclada al fondo y a la derecha 
del panel cuando este cambie de tamaño, asigne a su propiedad Anchor el valor 
Bottom, Right. El resultado final del diseño realizado puede ser similar al siguiente: 





& Nuevo diente Realizar pedido Ë} Mostrar pedidos 








A continuación, vamos a añadir el controlador de cada menú. Para ello, solo 
tiene que hacer doble clic sobre el título de cada uno de ellos. 


private void menuNuevoCliente_Click(object sender, EventArgs e) 
{ 

// 
) 


private void menuRealizarPedido_Click(object sender, EventArgs e) 
{ 

/1 
} 


private void menuMostrarPedidos_Click(object sender, EventArgs e) 
{ 
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1! 
) 


El paso siguiente es crear los formularios hijo. Para ello, inicialmente vamos a 
crear una plantilla que defina las partes en común que van a tener estos formula- 
rios. Una plantilla no es más que un formulario. Por lo tanto, añada un nuevo for- 
mulario a la aplicación denominado formPlantilla. Personalice este formulario 
para que tenga una apariencia de su agrado. Por ejemplo, cambie el color de fon- 
do, quite los botones de la barra de título (propiedad ControlBox a false), etc. 


A continuación, añadimos los controles comunes que va a tener este tipo de 
formularios; por ejemplo, una etiqueta para poner un título, un marco que agrupe 
los controles que añadamos a cada formulario en particular y dos botones, Aceptar 
y Cancelar. 


Personalice los controles añadidos y asigne a su propiedad Anchor los valo- 
res adecuados para que independientemente del tamaño del formulario, conserven 
su posición relativa a los bordes del formulario. Asigne también a la propiedad 
AcceptButton el nombre del botón Aceptar y a CancelButton el del botón Can- 
celar. 


Finalmente, añada los controladores de estos botones para que, por ahora, 
simplemente cierren el formulario: 


private void btAceptar_Click(object sender, EventArgs e) 
( 

Close(); 
) 


private void btCancelar_Click(object sender, EventArgs e) 
( 

Close(); 
) 


El resultado, una vez finalizado el diseño, podría ser análogo al siguiente: 
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formPlantilla 


Aceptar Cancelar 








Compile el proyecto para verificar que todo es correcto hasta ahora. Bien, 
ahora nos preguntamos, ¿cómo se añade a la aplicación un formulario que utilice 
esta plantilla? Pues añadiendo un nuevo formulario y modificando el código aña- 
dido por el asistente (fichero nombre-formulario.Designer.cs) para que se derive 
de formPlantilla en lugar de derivarse de Form. Ahora bien, para que la clase de- 
rivada tenga acceso a las propiedades de los controles que hereda de la plantilla, 
asigne a la propiedad Modifiers de cada uno de ellos el valor Protected. 


Según lo expuesto, vamos a añadir un nuevo formulario denominado form- 
NuevoCliente. A continuación, abra el fichero formNuevoCliente.cs y modifique 
el código para que este formulario se derive de formPlantilla: 


public partial class formNuevoCliente : formPlantilla 
( 

// 
) 


Cuando ahora vuelva a la ventana de diseño de formNuevoCliente, observará 
que el formulario creado tiene el mismo diseño de la plantilla. Cambie la propie- 
dad Text de la etiqueta al valor “Nuevo cliente”. 


A continuación, siguiendo un proceso análogo al expuesto para añadir for- 
mNuevoCliente, añada los formularios formRealizarPedido y formMostrarPedi- 
dos. 


Una alternativa para añadir un formulario que se derive de otro es, cuando se 
cree el formulario, utilizar la plantilla Windows Forms > Formulario heredado. 
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Solo nos queda visualizar los formularios. Este código lo tenemos que escribir 
en cada uno de los métodos asociados con los menús de la barra de menús. Por 
ejemplo, el método correspondiente al menú Nuevo cliente sería así: 


private void menuNuevoCliente_Click(object sender, EventArgs e) 
foreach (Form f in this.MdiChildren) 
if (f.Name == "formNuevoCliente”) 
i f.Activate(); 
return; 


1 
$ 


} 
formNuevoCliente formHijo = new formNuevoCliente(); 


formHijo.MdiParent = this; 
formHijo.WindowState = FormWindowState.Maximized; 


formHijo.Show():; 


Este método primero verifica si el formulario hijo ya está creado; si está crea- 
do, simplemente le asigna el foco, y si no, lo crea y lo visualiza maximizado. 


Cuando ejecute la aplicación y haga clic en Nuevo cliente se mostrará el for- 
mulario que se ve en la figura siguiente, en la que el formulario hijo aparece ma- 
ximizado dentro del formulario padre: 








Y 


a9 Bodega - [formNuevoCliente] 











& Nuevo diente {Ë$ Realizar pedido ¿El Mostrar pedidos 
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EJERCICIOS PROPUESTOS 


1. Visor de imágenes. En el capítulo anterior desarrollamos un visor de imágenes 
bajo una interfaz gráfica que solo podía mostrar una imagen cada vez. Reescriba 
esta aplicación para que pueda mostrar varias imágenes simultáneamente, cada una 
en una ventana, conservando la funcionalidad que allí dimos a esa aplicación y 
ampliándola en lo que considere necesario. 


2. Anteriormente, en este capítulo, construimos un editor de texto capaz de tener 
varios documentos abiertos simultáneamente, para lo cual utilizamos una aplica- 
ción MDI. En esta aplicación, todas las ventanas hija se derivaban de una misma 
clase FormDocumento. Añada a la aplicación una nueva clase de ventanas hija, 
FormDocumento2, con sus propias barras de menús y herramientas, y permita que 
se construyan ambos tipos de ventana. Cuando ejecute la aplicación observará que 
el método encargado de fusionar las barras de herramientas hija y padre da un 
error al obtener la ventana activa, ya que el tipo de esta ventana ahora puede ser 
FormDocumento o FormDocumento2. Para que la solución a este problema no de- 
penda de los tipos de ventanas hija que podamos añadir se aconseja implementar 
una interfaz (interface) que obligue a la clase que la implemente (las clases de las 
distintas ventanas hija) a añadir a la misma un método que devuelva una referencia 
a su barra de herramientas. ¿Cómo soluciona esta forma de proceder el problema 
que se ha presentado? Recuerde que una variable del tipo de una interfaz puede re- 
ferenciar un objeto de cualquier clase que implemente dicha interfaz. 


CAPÍTULO 10 


O F.J.Ceballos/RA-MA 


CONSTRUCCIÓN DE CONTROLES 


Además de la gran cantidad de controles que proporciona Visual Studio, también 
tenemos la posibilidad de crear nuestros propios controles a medida de una forma 
fácil. 


¿Cuándo construir controles a medida y por qué? Cuando escribimos una uti- 
lidad interesante que, además, puede utilizarse en diferentes aplicaciones, es una 
buena idea empaquetarla en un control a medida para utilizarla de forma sencilla 
en todos los proyectos donde sea necesaria. También, en ocasiones será útil dise- 
ñar un nuevo control a partir de otro existente para adaptar sus características a 
nuestras necesidades. 


Para realizar este tipo de desarrollos hay que conocer los conceptos de pro- 
gramación orientada a objetos y, en particular, el mecanismo de herencia. 


Resumiendo, un control a medida es una aplicación que, generalmente, mues- 
tra una interfaz gráfica y una interfaz de programación al desarrollador de aplica- 
ciones. La interfaz gráfica es la que el desarrollador ve cuando lo coloca en un 
formulario (la misma que verán los usuarios cuando ejecuten la aplicación) y la 
interfaz de programación es el conjunto de propiedades, métodos y eventos que el 
desarrollador utiliza para acceder a la funcionalidad proporcionada por el control. 


REUTILIZACIÓN DE CONTROLES EXISTENTES 


El control más simple que podemos construir es uno que mejore la funcionalidad 
de otro control existente. Esto es, en ocasiones puede ser interesante ampliar la 
funcionalidad mostrada por un control. Por ejemplo, pensemos en el control Text- 
Box que hemos venido utilizando a lo largo de los capítulos de este libro. En más 
de una ocasión, hemos diseñado un formulario para entrada de datos que presen- 
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taba varios controles TextBox. Pues bien, para ayudar al usuario a identificar la 
caja de texto que tiene el punto de inserción (control donde se van a introducir da- 
tos en ese instante) sería una buena idea cambiar su color cuando tiene el foco. 
También sería otra buena idea dar formato a su contenido una vez que el control 
pierda el foco; por ejemplo, si se trata de una cantidad en euros, podríamos hacer 
que se mostraran, además de la coma decimal, los puntos de los miles, incluso 
cambiar el color del dato cuando la cantidad sea negativa. 


¿Cómo abordamos el problema propuesto? Podríamos programar las caracte- 
rísticas expuestas en el desarrollo de la aplicación en curso, pero esto no facilitaría 
su uso en otras aplicaciones. La mejor solución es crear un control nuevo que he- 
rede toda la funcionalidad del control TextBox existente y añada la funcionalidad 
deseada. Esto es lo que haremos a continuación (véase también el apartado Ejer- 
cicios resueltos). 


Control TextBox extendido 


Vamos a denominar a este nuevo control TextBoxEx. Para empezar, cree un nuevo 
proyecto, seleccione la plantilla Biblioteca de controles de Windows Forms y de- 
nomine al proyecto TextBoxEx. Otra alternativa es crear un nuevo proyecto vacío, 
añadir un nuevo elemento basado en la plantilla “control de usuario” y establecer 
en las propiedades del proyecto que la aplicación va a ser de tipo Class Library. 


e , a Voua P: mi O X 
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Obsérvese el elemento UserControl1; es el control. Presenta una parte gráfi- 
ca, la que vemos en la ventana de diseño, y un fichero UserControll.cs que alma- 
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cenará el código. Cambie el nombre al control sustituyendo el actual por TextBox- 
Ex. Para ello, haga clic sobre UserControl1.cs en el explorador de soluciones y 
cambie el nombre en la ventana de propiedades. El proceso de refactorización ha- 
ce el resto de los cambios donde sea necesario (la refactorización [refactoring] 
consiste en modificar la forma del código sin alterar su funcionamiento). Por 
ejemplo, abra el fichero de código TextBoxEx.cs y comprobará que ahora la clase 
que dará lugar al control se llama TextBoxEx y se deriva de UserControl, clase de 
la que se derivan todos los controles de usuario: 


public partial class TextBoxEx : UserControl 
( 

11 
) 


Hay otro fichero de código: TextBoxEx.Designer.cs; se trata del fichero donde 
el asistente de diseño almacena el código generado por él. 


Pero, anteriormente, dijimos que nuestro control iba a heredar toda la funcio- 
nalidad de TextBox. Para ello, reescriba la clase anterior como se muestra a con- 
tinuación: 


public partial class TextBoxEx : TextBox 
( 

1! 
) 


Al realizar la operación descrita observará que Visual Studio le avisa de posi- 
bles errores; quizás tenga que suprimir alguna línea porque accede a miembros 
que nuestra clase no tiene, por ejemplo. 


Si vuelve a la ventana de diseño, observará que la interfaz gráfica que veía- 
mos inicialmente ha desaparecido. Esto es así porque al diseñador no le está per- 
mitido cambiar los controles predefinidos como TextBox. 


Para construir el nuevo control con la funcionalidad heredada de TextBox, 
compile el proyecto; se generará un fichero TextBoxEx.dll (puede verlo en la sub- 
carpeta bin del proyecto). Ya tenemos creado el nuevo control de tipo TextBoxEx. 


Para probar este control vamos a construir una nueva aplicación Windows, 
con el fin de incluir el control en el formulario de esta aplicación. Añada un nuevo 
proyecto a la solución: clic con el botón secundario del ratón sobre el nombre de 
la solución y después ejecute Agregar > Nuevo proyecto. En la ventana que se 
muestra, elija la plantilla Aplicación de Windows Forms, como nombre del pro- 
yecto Test, y como ubicación elija la ruta del proyecto anterior (se creará una sub- 
carpeta de TextBoxEx). 
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A continuación, vamos a añadir al formulario un control TextBoxEx. Com- 
pruebe si se ha añadido una entrada TextBoxEx en la caja de herramientas. En ca- 
so afirmativo, arrastre el control sobre el formulario. En el nodo References del 
proyecto se añadirá una referencia a dicho control. En caso negativo, hay que 
añadir una referencia a este control en el proyecto Test. Para ello, haga clic con el 
botón secundario del ratón sobre el nombre Test del proyecto y después ejecute 
Agregar referencia > Proyectos > TextBoxEx > Aceptar. Ahora compruebe que 
se ha añadido una entrada TextBoxEx en la caja de herramientas. 


Nota: si el control no aparece en la caja de herramientas, ejecute Herramien- 
tas > Opciones > Diseñador de Windows Forms > General > Cuadro de herra- 
mientas y asigne a la propiedad AutoToolboxPopulate el valor true. 


Compile el proyecto Test y ejecútelo. Asegúrese previamente de que Test es el 
proyecto de inicio; si no lo es, haga clic con el botón secundario del ratón sobre el 
nombre del proyecto y seleccione Establecer como proyecto de inicio. Observará 
que el comportamiento del control TextBoxEx es el mismo que el de TextBox, de 
hecho, en este instante, es un control TextBox pero con un nombre distinto. 


A continuación vamos a añadir al control alguna funcionalidad extra como la 
comentada anteriormente. Empecemos por cambiar el color del control cuando 
adquiera el foco y restaurar su color inicial cuando lo pierda. 


Para ello, añada tres propiedades: ColorControlEnfocado, ColorControl- 
Desenfocado y AplicarColorFoco, vinculadas con los valores que se indica a con- 
tinuación y que debe definir como atributos privados de la clase TextBoxEx: 


public partial class TextBoxEx : TextBox 

( 
private Color _ColorControlEnfocado = Color.LightCyan; 
private Color _ColorControlDesenfocado = Color.White; 
private bool _AplicartolorFoco = false; 
1/ 


La propiedad ColorControlEnfocado almacenará el color que mostrará el con- 
trol cuando reciba el foco y la propiedad ColorControlDesenfocado almacenará el 
color que mostrará el control cuando pierda el foco, solo, en ambos casos, si la 
propiedad AplicarColorFoco vale true. 


La propiedad AplicarColorFoco vale por omisión false, lo que asegura un 
comportamiento inicial del control TextBoxEx idéntico al control TextBox. 


A continuación implemente en la clase TextBoxEx las propiedades descritas: 
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public Color ColorControlEnfocado 
( 
get [ return _ColorControlEnfocado; } 
set { _ColorControlEnfocado = value; ) 
) 


public Color ColorControlDesenfocado 
( 
get { return _ColorControlDesenfocado:; ) 
set { _ColorControlDesenfocado = value; } 
) 


public bool AplicarlolorFoco 
( 
get { return _AplicarColorFoco; ) 
set { _AplicarColorfFoco = value; ) 





Ahora, si selecciona el control TextBoxEx que añadió anteriormente al formu- 
lario del proyecto Test, podrá observar estas propiedades en la ventana de propie- 
dades del entorno de desarrollo, lo que le permitirá asignar de una forma sencilla 
los valores que desee. 

















Propiedades vAax 
TextBoxEx1 TextBoxEx.TextBoxEx z 
sm j[ojgs # 

AutoCompleteMode None za 

AutoCompleteSource None 

BackColor E Window 

BorderStyle Fixed3D 

CausesValidation True 

CharacterCasing Normal 


ColorControlDesenfocadc|_] White 


ColorControlEnfocado [] LightCyan z 














ContextMenuStrip (ninguno) 
Cursor IBeam 
Dock None t4 


ColorControlEnfocado 


Finalmente, tenemos que asignar a la propiedad BackColor del control el va- 
lor de ColorControlEnfocado cuando este reciba el foco y el valor de ColorCon- 
trolDesenfocado cuando pierda el foco. Por lo tanto, muestre la vista de diseño 
del control, diríjase a la ventana de propiedades, muestre el panel de eventos y 
añada los controladores de los eventos Enter y Leave. El primero se produce 
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cuando el control recibe el foco y el segundo cuando lo pierde. Una vez añadidos, 
edítelos como se indica a continuación: 


private void TextBoxEx_Enter(object sender, EventArgs e) 
( 
if ClAplicarColorfoco) return; 
BackColor = ColorControlEnfocado; 


1 
$ 


private void TextBoxEx_Leave(object sender, EventArgs e) 

( 
if (ClAplicarColorfFoco) return; 
BackColor = ColorControlDesenfocado; 








Para probar este control con sus nuevas propiedades puede diseñar una venta- 
na análoga a la siguiente. Esta ventana muestra tres cajas de texto, de la clase Tex- 
tBoxEx, y un botón. Asigne a la propiedad AplicarColorFoco de las dos primeras 
cajas el valor true para que utilicen los colores predeterminados por las propieda- 
des ColorControlEnfocado y ColorControlDesenfocado. La tercera caja déjela 
con los valores por omisión, excepto para la propiedad ReadOnly a la que asigna- 
rá el valor true. 





| - 
a Formi La ES 








123456, 78] 
786543,21 


-£663086,43 























Con respecto al botón Calcular podemos implementar cualquier proceso sen- 
cillo. Por ejemplo, mostrar en la tercera caja la diferencia entre los valores de la 
primera y de la segunda. 


Compile la solución (se compilan los proyectos TextBoxEx y Test) y ejecute 
la aplicación Test. Observará que de las dos primeras cajas de texto, la que tiene el 
foco presenta el color programado. Idem cuando lo pierde. 
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Clasificación de las propiedades de un control 


La ventana de propiedades de un control tiene un botón, Por categorías, que per- 
mite clasificar las propiedades del control por categorías: “Accesibilidad”, “Apa- 
riencia”, “Comportamiento”, etc. 


Para especificar la categoría en la que se desea ubicar una propiedad hay que 
hacerlo mediante el atributo Category de la misma. Por ejemplo, la siguiente pro- 
piedad pertenece a la categoría “Apariencia”: 


[Category("Apariencia”)] 

public Color ColorControlEnfocado 

( 
get { return _ColorControlEnfocado; } 
set [ _ColorControlEnfocado = value; ) 


} 
Por omisión se supone la categoria “Varios”. 


Otro atributo es Description, el cual permite especificar una leyenda acerca 
de la finalidad de la propiedad (la leyenda que aparece en el fondo de la ventana 
de propiedades). Por omisión, la leyenda se reduce al nombre de la propiedad. 


[Category("Apariencia"), 

Description("Almacena el color que mostrará el control " + 
"cuando reciba el foco, solo si la propiedad " + 
"AplicarColorFoco vale true")] 

public Color ColorControlEnfocado 
( 
get { return _ColorControlEnfocado; } 
set [ _ColorControlEnfocado = value; } 
) 


CONTROLES DE USUARIO 


Un control de usuario es un objeto derivado de la clase UserControl. Este control 
proporciona el medio para crear y reutilizar interfaces gráficas de usuario. En 
esencia es un componente con interfaz gráfica, lo que significa que puede incluir 
uno o más controles de formularios Windows y componentes o bloques de códi- 
go, que pueden extender su funcionalidad mediante la validación de la entrada del 
usuario, la modificación de las propiedades de presentación o la ejecución de otras 
tareas. Una vez construido, puede incluirse en un formulario Windows igual que 
cualquier otro control. 
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Como ejemplo, vamos a construir un control que denominaremos Alarma que 
tendrá como finalidad generar un evento cuando la hora actual coincida con la ho- 
ra programada (hora de la alarma). Este control tiene en cuenta también la fecha y 
puede programarse para 24 horas. A diferencia del control Timer de Visual CF, 
este control mostrará una interfaz gráfica y lanzará un único evento. 


La interfaz del control Alarma presentará: 


e Un control MaskedTextBox: ctAlarma. Permitirá introducir la fecha-hora de 
la alarma y mostrará, en función de la opción elegida, la fecha-hora de la 
alarma o la actual. 

e Dos botones de opción: boFechaHoraAlarma y boFechaHoraActual. Permiti- 
rán seleccionar qué tipo de información visualizará ctAlarma. 

e Un control Timer: Timer]. 

e Dos propiedades: Activada, de tipo bool, y FechaHoraAlarma, de tipo Date- 
Time. 

e Dos métodos: IniciarTemporizador y PararTemporizador. 

e Un evento: TiempoAgotado. 





r T 


ag Alarma canale] 








E - - p 01/01/2013 12:00:00 


O) Fechahora alarma O) Fecha+hora alarma 























Fecha-+hora actual © Fecha-+hora actual 
l Activar alama | 
Control Alarma Formulario para test de Alarma 


Construir el control de usuario 


Cree un nuevo proyecto que cree un control Windows, igual que lo hizo en el 
apartado Control TextBox extendido, y denomine al proyecto Alarma. 


En el explorador de soluciones seleccione el fichero UserControll.cs, diríjase 
a la ventana de propiedades y cambie su nombre a Alarma.cs. Obsérvese en este 
fichero que el control de usuario será un objeto de la clase Alarma derivada de 
UserControl. 


Desde la caja de herramientas arrastre un control MaskedTextBox denomi- 
nado ctAlarma. Asigne a su propiedad Mask el valor “00/00/0000 90:00:00” y 


CAPÍTULO 10: CONSTRUCCIÓN DE CONTROLES 381 


ajuste el tamaño de la fuente al valor deseado. Arrastre también un control Timer 
y asigne a su propiedad Interval el valor 1000 (aparecerá en la bandeja de com- 
ponentes, al fondo). Arrastre dos botones de opción y configúrelos como se ob- 
serva en la figura anterior. Finalmente, ajuste el tamaño del control al espacio 
ocupado por los controles añadidos. 


Una vez diseñado el control, estamos preparados para añadir las propiedades, 
los métodos y los eventos anteriormente enunciados. 


Añadir propiedades 


Para añadir las propiedades, lo primero que hay que hacer es declarar en la clase 
Alarma las variables privadas que almacenarán sus valores: 


public partial class Alarma : UserControl 
( 

private bool _Activada; 

private DateTime _FechaHoraAlarma; 


Fi 
) 


Las variables _Activada y _FechaHoraAlarma almacenarán los valores de las 
propiedades Activada y FechaHoraAlarma, respectivamente. La variable _4cti- 
vada será true mientras la alarma se esté ejecutando y FechaHoraAlarma alma- 
cenará la fecha y la hora bajo el formato “dd/MM/yyyy HH:mm:ss” (para los 
formatos de fechas y horas véase en la ayuda el método DateTime.ToString(str); 
alternativamente, puede utilizar el método Format de String). 


La propiedad Activada es de solo lectura y devolverá el valor de la variable 
_Activada: true si la alarma está activada y false en caso contrario. 


public bool Activada 
( 

get { return _Activada; } 
) 


La propiedad FechaHoraAlarma es de lectura y escritura. Devolverá el valor 
de la variable _FechaHoraAlarma de tipo DateTime, o bien asignará un valor a 
esta variable de ese tipo, además de mostrar este dato en el control ctAlarma. 


public DateTime FechaHoraAlarma 

( 
get { return _FechaHoraAlarma; ) 
set 


( 
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} 


_FechaHoraAlarma = value; 
ctAlarma.Text = value.ToString("dd/MM/yyyy HH:mm:ss"); 
} 


Añadir métodos 


A continuación añadimos el código para los métodos IniciarTemporizador y Pa- 
rarTemporizador. 


El método IniciarTemporizador obtiene del control MaskedTextBox la fecha 


y hora introducida por el usuario y verifica que tiene un formato correcto. Si el 
formato no es correcto, avisa al usuario de este error y aborta la operación de ini- 
ciar la alarma. Si el formato es correcto, entonces verifica que la fecha-hora de la 
alarma es posterior a la fecha-hora actual. Si no es posterior, avisa al usuario de 
este error y aborta la operación de iniciar la alarma. Si es posterior, activa la alar- 
ma y asigna a la variable _4Activada el valor true. 


public void IniciarTemporizador() 


( 


} 


// Asignar la fecha-hora introducida en el control 
// a la propiedad FechaHoraAlarma 
try 
( 
FechaHoraAlarma = DateTime.Parse(ctAlarma. Text); 
) 
catch (InvalidCastException) 
( 
MessageBox.Show("La fecha-hora alarma no es correcta"); 
return; 
) 





// No permitir asignar una fecha-hora anterior a la actual 
if (FechaHoraAlarma.CompareTo(Datelime.Now) <= 0) 
( 
MessageBox.Show("La fecha-hora alarma es menor que la actual"); 
return; 
) 
// Activar el temporizador 
if (lTimerl.Enabled) 
( 
Timerl.Enabled = true; 
_Activada = true; 
) 


El método PararTemporizador simplemente desactiva la alarma y asigna a la 


variable _Activada el valor false. 


CAPÍTULO 10: CONSTRUCCIÓN DE CONTROLES 383 


public void PararTemporizador() 


( 


} 


// Desactivar el temporizador 
if (Timer1.Enabled) 
{ 
Timerl.Enabled = false; 
_Activada = false; 


) 


Añadir eventos 


Un evento es la forma que tiene una clase de notificar a la aplicación cuándo ocu- 
rre alguna cosa de interés. En la implementación de un evento intervienen los si- 
guientes elementos: 


Una clase que guarde los datos del evento. Por ejemplo, NombreEventoEvent- 
Args. Esta clase se derivará de System.EventArgs. Si no hay datos relaciona- 
dos con el evento, no hace falta definirla. 


public class Nombre£vento£ventArgs : EventArgs 


{ 
11 


) 


Un delegado que defina el prototipo del método que responderá al evento. Por 
ejemplo NombreEventoEventHandler. Un delegado es una clase que puede 
guardar una referencia a un método. A diferencia de otras clases, una clase de 
delegado define un prototipo y puede guardar referencias únicamente a los 
métodos que coinciden con ese prototipo (podemos decir que un delegado 
equivale a un puntero a función con seguridad o a una devolución de llama- 
da). Su declaración para un evento es de la forma siguiente: 


public delegate void NombreEkventoEkventHandlerí 
Lobject sender, NombreEventoEventArgs el); 


Una declaración de delegado es suficiente para definir una clase de delegado. 
La declaración proporciona el prototipo del delegado y el CER la implemen- 
tación. 


Un atributo public, de la clase del control, que se corresponda con el evento. 
Esta definición tiene la forma siguiente: 


public event NombrekventotventHandler NombreEvento; 
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Un método, de la clase del control, que genere el evento. Por ejemplo On- 
NombreEvento. 


protected virtual void OnNombre£vento(NombreEventokventArgs e) 
{ 
if (NombreEvento != null) 
{ 
// Invocar al delegado 
NombreEvento(this, e); 
} 
} 


Hemos respetado el convenio de nombres de .NET Framework. Por ejemplo, 


si necesitamos que la clase Alarma provoque un evento denominado TiempoAgo- 
tado, necesitamos los siguientes elementos: 


// Clase que define los datos para el evento TiempoAgotado 
public class TiempoAgotadoEventArgs : EventArgs 


( 
) 


// Delegado para el evento 
public delegate void TiempoAgotadoEventHandler( 


object sender, TiempoAgotadoEventArgs e); 


// Clase que define el evento 
public partial class Alarma : UserControl 


( 


private bool _Activada; 
private DateTime _FechaHoraAlarma; 





// Evento TiempoAgotado; es implementado por un 
// delegado TiempoAgotadoEventHandler 
public event TiempoAgotadoEventHandler TiempoAgotado; 











// Método que genera el evento invocando al delegado 
protected virtual void OnTiempoAgotado(TiempoAgotadoEventArgs e) 


( 


) 











if (TiempoAgotado != null) 
( 
// Invocar al delegado 
TiempoAgotado(this, e); 
) 


1/ 


Este evento no define datos, por lo que no necesitaríamos definir la clase de- 


rivada de EventArgs, ni tampoco definir argumentos en el delegado. Si lo hemos 
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hecho, ha sido por generalizar y por seguir los mismos criterios que .NET Fra- 
mework para implementar cualquier evento. No obstante, como ejemplo, puede 
hacer que proporcione el objeto FechaHoraAlarma. 


El evento TiempoAgotado solamente informará a la aplicación que utilice un 
control Alarma de que el tiempo programado para poner en marcha un determina- 
do proceso se ha cumplido. Para generar este evento se debe alcanzar el tiempo 
programado, comprobación que será realizada por el controlador del evento Tick 
de Timerl; por lo tanto, aquí es donde se invocará a OnTiempoAgotado. 


El controlador del evento Tick de Timer] hará lo siguiente: cuando el valor 
de la fecha y la hora actual alcance el valor de la fecha y la hora a la que debe sal- 
tar la alarma, se desactivará el temporizador, se pondrá la variable _Activada al 
valor false y se generará el evento TiempoAgotado; mientras no alcance ese valor, 
mostrará en el control MaskedTextBox la fecha y la hora a la que debe saltar la 
alarma o la fecha y la hora actual, dependiendo de la opción seleccionada. 


private void Timer1_Tick(object sender, EventArgs e) 
( 
// Si se agotó el tiempo, generar el evento TiempoAgotado 

if (DateTime.Now.CompareTo(FechaHoraAlarma) >= 0) 

( 
Timerl.Enabled = false; 
_Activada = false; 
if (TiempoAgotado != null) 

OnTiempoAgotado(new TiempoAgotadoEventArgs()); 
return; 








) 
//Wisualizar 

if (boFechaHoraAlarma.Checked) 
( 








//fecha-hora alarma 
ctAlarma.Text = FechaHoraAlarma.ToString("dd/MM/yyyy HH:mm:ss"); 
) 
else 
( 
//fecha-hora actual 
ctAlarma.Text = DateTime.Now.ToString("dd/MM/yyyy HH:mm:ss"); 
) 
) 


Opciones fecha-hora alarma o actual 


Según hemos dicho anteriormente, el control MaskedTextBox mostrará la fecha 
y la hora a la que debe saltar la alarma o bien la fecha y la hora actual, proceso 
que realizarán los controladores del evento CheckedChanged dependiendo de la 
opción seleccionada. Asegúrese de que durante el diseño asignó a la propiedad 


386 ENCICLOPEDIA DE MICROSOFT VISUAL CH 


Checked de boFechaHoraAlarma el valor true, para que este botón aparezca ini- 
cialmente seleccionado. Además, cuando se muestre la fecha y la hora actual, no 
se permitirá escribir en el control MaskedTextBox. 


private void boFechaHoraAlarma_CheckedChanged(object sender, EventArgs e) 


( 
if (lboFechaHoraAlarma.Checked) return; 
ctAlarma.ReadOnly = false; 
ctAlarma.Text = FechaHoraAlarma.ToString("dd/MM/yyyy HH:mm:ss"); 


) 


private void boFechaHoraActual_CheckedChanged(object sender, EventArgs e) 


( 
if (lboFechaHoraActual.Checked) return; 
ctAlarma.Read0Only = true; 
ctAlarma.Text = DatelTime.Now.ToString("dd/MM/yyyy HH:mm:ss"); 


1 
S 

Las sentencias if evitan que el método se ejecute cuando un botón de opción 
pasa a no estar activado cuando se activa el que no lo estaba. 


Verificar el control de usuario 


Añada un nuevo proyecto Windows denominado Test a la solución anterior (plan- 
tilla Aplicación de Windows Forms). Lo ubicaremos en la carpeta del proyecto 
Alarma. Una vez añadido, haga que sea el proyecto activo. 


Desde la caja de herramientas, arrastre un control Alarma, denominado Alar- 
mal, una etiqueta, denominada etEstadoAlarma, y un botón de pulsación, deno- 
minado btAlarma: 





A 









e Alarma 





15/10/2013 12:30:00 
© Fecha-+hora alama 
Fecha-hora actual 


Alarma desactivada 














Ahora podrá observar en la ventana de propiedades del control Alarma sus 
propiedades Activada y FechaHoraAlarma y el evento TiempoAgotado. 
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Cuando ejecute la aplicación y se muestre el formulario, si lo deseamos, po- 
demos iniciar el control alarma a través del controlador del evento Load del for- 
mulario. También se puede introducir este valor escribiendo directamente en el 
control Alarma, solo si la opción Fecha-hora alarma está activada. 


private void Forml_Load(object sender, EventArgs e) 
( 

Alarmal.FechaHoraAlarma = DateTime.Parse("1/1/2013 12:00:00 PM"); 
) 


Obsérvese en el código escrito hasta ahora cómo para convertir un DateTime 
en un String hemos empleado el método DateTime.ToString (véase también en 
la ayuda la clase DateTimeFormatInfo para otros formatos), y para convertir un 
String en un DateTime hemos empleado el método DateTime.Parse. 


Cuando la alarma no esté activada, la etiqueta etEstadoAlarma mostrará 
“Alarma desactivada” y el botón btAlarma “Activar alarma”. Cuando el usuario 
haga clic en el botón de pulsación Activar alarma se activará la misma si la fecha 
y hora introducidas son válidas. En este instante, la etiqueta mostrará “Alarma ac- 
tivada” y el botón indicará “Desactivar alarma”. 


private void btAlarma_Click(object sender, EventArgs e) 
( 
if (lAlarmal.Activada) 
Alarmal.IniciarTemporizador(); 
else 
Alarmal.PararTemporizador(); 


if (Alarmal.Activada) 
( 





btAlarma.Text = "Desactivar alarma"; 
etEstadoAlarma.lext = "Alarma activada"; 
etEstadoAlarma.ForeColor = Color.Red; 


) 


else 

( 
btAlarma.Text = "Activar alarma"; 
etEstadoAlarma.Text = "Alarma desactivada"; 


etEstadoAlarma.Forelolor = Color.Blue; 
) 
) 


Cuando el usuario quiera ver la hora actual, hará clic en el botón Fecha-hora 
actual. 


Cuando el valor de la fecha y la hora actual alcance el valor de la fecha y la 
hora a la que debe saltar la alarma, se generará el evento TiempoAgotado. Para 
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comprobar esta situación añada el controlador para este evento (proceda de la 
misma forma que lo hace para cualquier otro evento). 


private void Alarmal_TiempoAgotado(object sender, 
TiempoAgotadoEventArgs e) 
( 
MessageBox.Show("Se generó el evento TiempoAgotado"); 
btAlarma.Text = "Activar alarma"; 
etEstadoAlarma.Text = "Alarma desactivada"; 
etEstadoAlarma.ForeClolor = Color.Blue; 





Al añadir este controlador, el asistente para diseño de formularios añadió la 
siguiente línea de código en el fichero Form1.Designer.cs: 


Alarmal.TiempoAgotado += 


new TiempoAgotadoEventHandler(Alarmal_TiempoAgotado) ; 


Esta línea asigna a la lista de métodos que serán llamados cuando el evento 
TiempoAgotado sea generado, la referencia al método Alarmal_TiempoAgotado. 


EJERCICIOS RESUELTOS 


1. Crear un control TextBoxEx derivado de TextBox con las características expues- 
tas cuando expusimos este problema al principio de este capítulo, pero ahora par- 
tiendo de un proyecto vacío al que añadiremos una clase derivada de TextBox, en 
lugar de utilizar, como hicimos anteriormente, un proyecto basado en la plantilla 
Biblioteca de controles Windows. 


Para empezar, cree un nuevo proyecto de tipo Visual C# > Windows Forms, 
seleccione la plantilla Proyecto vacío y denomine al proyecto TextBoxEx. 


Añada al proyecto una clase TextBoxEx pública (public) derivada de Text- 
Box. Haga clic con el botón secundario del ratón sobre el nombre del proyecto y 
ejecute Agregar > Clase. Denomine a la clase TextBoxEx: 


public class TextBoxEx : TextBox 
( 


) 


Antes de continuar, vamos a establecer las propiedades de este proyecto. Se- 
gún lo aprendido anteriormente en este mismo capítulo, queremos crear un con- 
trol; el resultado será la biblioteca TextBoxEx.dll. Según esto, haga clic con el 
botón secundario del ratón sobre el nombre del proyecto y ejecute Propiedades. 
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Haga clic en la pestaña Aplicación. En el panel Aplicación seleccione como tipo 
de proyecto Biblioteca de clases. Cierre la ventana de Propiedades. 


Después haga clic con el botón secundario del ratón sobre el nodo Referen- 
cias y añada una referencia a la biblioteca System. Windows.Forms a la que perte- 
nece la clase TextBox y añada en el código la sentencia using correspondiente. 


using System.Windows.Forms; 


public class TextBoxEx : TextBox 
( 


} 


Para construir el nuevo control con la funcionalidad heredada de TextBox, 
compile el proyecto; se generará un fichero TextBoxEx.dll (puede verlo en la sub- 
carpeta bin del proyecto). Ya tenemos creado el nuevo control de tipo TextBoxEx. 


Para probar este control vamos a construir una nueva aplicación Windows, 
con el fin de añadir el control al formulario de esta aplicación. Añada un nuevo 
proyecto a la solución de nombre Test. Elija la plantilla Aplicación de Windows 
Forms, y como ubicación tome la ruta del proyecto anterior (se creará una subcar- 
peta de TextBoxEx). 


A continuación, vamos a añadir al formulario un control TextBoxEx. Com- 
pruebe si se ha añadido una entrada TextBoxEx en la caja de herramientas. En ca- 
so afirmativo, arrastre el control sobre el formulario. En el nodo References del 
proyecto se incluirá una referencia a dicho control. En caso negativo, hay que 
añadir una referencia a este control en el proyecto Test. Para ello, haga clic con el 
botón secundario del ratón sobre el nombre Test del proyecto y después ejecute 
Agregar referencia > Proyectos > TextBoxEx > Aceptar. Ahora compruebe que 
se ha añadido una entrada TextBoxEx en la caja de herramientas. 


Compile el proyecto Test y ejecútelo. Asegúrese previamente de que Test es 
el proyecto de inicio. Observará que el comportamiento del control TextBoxEx es 
el mismo que el de TextBox. 


A continuación, vamos a añadir al control alguna funcionalidad extra como la 
comentada anteriormente cuando planteamos la construcción de este control. Esto 
es, a partir de aquí, el proceso que desarrollamos en el apartado Control TextBox 
extendido se repite, como puede ver de forma resumida a continuación. No olvide 
añadir las referencias a las bibliotecas que sean necesarias. 
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Añada tres propiedades: ColorControlEnfocado, ColorControlDesenfocado y 
AplicarColorFoco, vinculadas con los valores que se indican a continuación y que 
debe definir como atributos privados de la clase TextBoxEx: 


public class TextBoxEx : TextBox 

( 
private Color _ColorControlEnfocado = Color.LightCyan; 
private Color _ColorControlDesenfocado = Color.White; 
private bool _AplicarColorFoco = false; 
1! 


A continuación implemente en la clase TextBoxEx las propiedades descritas. 


public Color ColorControlEnfocado 
( 
get { return _ColorControlEnfocado; } 
set { _ColorControlEnfocado = value; ) 


} 


public Color ColorControlDesenfocado 
{ 
get { return _ColorControlDesenfocado; ) 
set { _ColorControlDesenfocado = value; } 


} 


public bool AplicarColorFoco 
( 
get [ return _AplicarColorrFoco; ) 
set { _AplicarColorfFoco = value; ) 


} 





Finalmente, tenemos que asignar a la propiedad BackColor del control el va- 
lor de ColorControlEnfocado cuando este reciba el foco y el valor de ColorCon- 
trolDesenfocado cuando pierda el foco. Para ello implemente los controladores 
mostrados a continuación: 


private void TextBoxEx_Enter(object sender, EventArgs e) 
{ 
if (!AplicarColorFoco) return; 

BackColor = ColorControlEnfocado; 
) 


private void TextBoxEx_Leave(object sender, EventArgs e) 

( 
if (lAplicarColorFoco) return; 
BackColor = ColorControlDesenfocado; 


} 
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Falta indicar en respuesta a qué eventos se ejecutarán los métodos anteriores. 
Esto lo podemos especificar en el constructor de la clase así: 


public TextBoxEx() 

( 
this.Enter += new System.EventHandler(this.TextBoxEx_Enter); 
this.Leave += new System.EventHandler(this.TextBoxEx_Leave); 


1 
$ 








Para probar este control con sus nuevas propiedades puede diseñar una venta- 
na análoga a la siguiente: 





a 





123456,78] 


786543,21 


-663086,43 














Compile la solución (se compilan los proyectos TextBoxEx y Test) y ejecute 
la aplicación Test. Observará que de las dos primeras cajas de texto, la que tiene el 
foco presenta el color programado. Idem cuando lo pierde. 


EJERCICIOS PROPUESTOS 


1. Modifique el control Alarma para que la clase que almacena los datos del evento 
proporcione las seis propiedades de solo lectura siguientes: dia, mes, año, hora, 
minutos y segundos a los que saltó la alarma. 


2. Imprimir el contenido de un control RichTextBox. El control RichTextBox no 
proporciona un método para imprimir su contenido. Sin embargo, puede extender 
la clase RichTextBox para utilizar el mensaje EM_FORMATRANGE y enviar 
el contenido del control a un dispositivo de salida como una impresora. Se propo- 
ne realizar este nuevo control. 


El mensaje EM_FORMATRANGE de Win32 formatea un rango de texto de 
un control RichTextBox para enviarlo a un dispositivo especificado. 


Una vez creado el control, para probarlo, siga estos pasos: 
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1. Cree una nueva aplicación Windows. Se crea Forml.cs. 


2. Desde la caja de herramientas, arrastre un botón sobre Forml. Cambie el 
nombre a btConfigurarPag y el título a Configurar página. 


3. Desde la caja de herramientas, arrastre otro botón a Form1. Cambie el nombre 
a btVistaPre y el título a Vista preliminar. 


4. Desde la caja de herramientas, arrastre otro botón a Form1. Cambie el nombre 
a btImprimir y el título a Imprimir. 


5. Desde la caja de herramientas, arrastre sobre Form1 los controles PrintDo- 
cument, PrintDialog, PrintPreviewDialog y PageSetupDialog. 


6. Modifique la propiedad Document de PrintDialogl, de PrintPreviewDialogl 
y de PageSetupDialogl a PrintDocumentl. 


7. Desde la caja de herramientas, arrastre RichTextBoxPrintCtrl a Forml. 


8. Escriba los controladores necesarios. 


CAPÍTULO 11 


O F.J.Ceballos/RA-MA 


PROGRAMACIÓN CON HILOS 





Como Windows es un sistema operativo multitarea, vamos a exponer en este capí- 
tulo cómo utilizar la infraestructura que aporta para dotar de paralelismo a nues- 
tras aplicaciones, aun cuando estas se ejecuten en un ordenador convencional con 
un único microprocesador. 


Evidentemente, las aplicaciones que constan de un único hilo de control resul- 
tan más fáciles de implementar y depurar que las aplicaciones con múltiples hilos 
que comparten, entre otros recursos, un mismo espacio de memoria. Por eso, en el 
caso de múltiples hilos, el entrelazado de las operaciones de los distintos hilos ha- 
ce difícil la detección de errores y más aún el corregirlos. En definitiva, todo re- 
sultaría mucho más sencillo si no hiciese falta la concurrencia. 


Ahora bien, ¿cuándo es necesaria la concurrencia? Supongamos la aplicación 
“procesador de textos Word” que tiene que ocuparse, además de la edición del 
texto, de la ortografía y de la gramática. Con un único hilo tendríamos que reali- 
zar esta verificación fuera del habitual trabajo de edición. Con el uso de hilos, po- 
demos aprovechar los periodos de inactividad de la UCP para ir haciendo la 
corrección ortográfica y gramatical mientras el usuario edita el texto. 


El ejemplo expuesto pone de manifiesto que el diseño correcto de una aplica- 
ción concurrente permitirá completar una mayor cantidad de trabajo en el mismo 
período de tiempo, pero también puede servir para que las interfaces gráficas res- 
pondan mejor a las órdenes del usuario o para la creación de aplicaciones que den 
servicio a múltiples clientes, como sucede con cualquier aplicación web. 


En definitiva, el principal objetivo del uso de hilos es mejorar el rendimiento 
del sistema para dar un mejor servicio al usuario. Un ejemplo típico es el caso de 
una aplicación con una interfaz gráfica de usuario, en la que hilos independientes 
se encargan de realizar las operaciones costosas (por ejemplo, tareas con mucho 
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cálculo) mientras que el hilo principal de la aplicación sigue gestionando los 
eventos procedentes de la interfaz de usuario. De esta forma, el control de la apli- 
cación vuelve a manos del usuario de forma inmediata permitiéndole seguir ope- 
rando. 


En la plataforma .NET un hilo se representa mediante un objeto de la clase 
Thread del espacio de nombres System.Threading. 


ESPACIO DE NOMBRES System.Threading 


Las clases y delegados que permiten la programación multiproceso están defini- 
das en el espacio de nombres System.Threading. Además de la clase Thread, 
que permite definir un hilo, y del delegado ThreadStart, que se emplea para es- 
pecificar el punto de entrada al hilo (para crear un hilo, este delegado se pasa co- 
mo parámetro al constructor de la clase Thread), System.Threading proporciona 
clases para la sincronización de hilos y del acceso a datos, tales como Mutex, 
Monitor, Interlocked o AutoResetEvent, y también incluye una clase Thread- 
Pool que permite utilizar un grupo de hilos suministrados por el sistema y una 
clase Timer que ejecuta métodos de devolución de llamada en hilos del grupo de 
hilos. 


Para introducirnos en este tema, vamos a generar una aplicación Windows 
que nos transmita la necesidad de utilizar un hilo secundario. Inicialmente, la 
aplicación utilizará solo el hilo principal (esto es, lo que entendemos por una apli- 
cación sin hilos). Esta aplicación mostrará un reloj que en todo momento indicará 
la hora actual y una barra de progreso que mostrará el estado de una tarea secun- 
daria que simulará una operación costosa (requiere un tiempo de cálculo elevado) 
que se iniciará cuando se haga clic en el botón Calcular. Para adaptarnos a las dis- 
tintas UCP de los lectores, hemos puesto también un control que permita variar el 
tiempo que necesitará la UCP para realizar los cálculos. 


Í ag Multiproceso lll SO) 
00:00:00 








Calcular 


Carga UCP: 150000 
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Cree una nueva aplicación Windows denominada ApMultiproceso que mues- 
tre una ventana de la clase Form con una etiqueta etHora. Asigne al formulario el 
título “Multiproceso” y ponga su propiedad MaximizeBox a false. Inicie la eti- 
queta con el valor “00:00:00”, permita que se redimensione automáticamente y 
asígnele una fuente de tamaño 16. 


Añada un control Timer y asígnele como nombre Temporizador. Asigne a su 
propiedad Enabled el valor true y a su propiedad Interval el valor 1000. 


Añada el controlador que responda a los eventos Tick del temporizador y 
complételo como se indica a continuación: 


private void Temporizador_Tick(object sender, EventArgs e) 
( 

etHora.Text = Datelime.Now.ToLonglimeString():; 
) 


Compile la aplicación, ejecútela y pruebe los resultados. Observará que la eti- 
queta muestra en todo momento la hora actual. 


Añada una barra de progreso (control ProgressBar) con el nombre bpProgre- 
so, una etiqueta etCargaUCP con el texto “Carga UCP”, un control NumericUp- 
Down llamado numCargaUCP y un botón con el nombre btCalcular. 


Después, defina las propiedades de numCargaUCP para asignar a este control 
un rango de valores de 100.000 a 100.000.000 con incrementos de 100.000 y con 
un valor inicial de 100.000, y de la barra de progreso para asignarle un rango de 
valores de 0 a 100 con incrementos de 1. 


¿Por qué no ponemos el rango de la barra de progreso de O a numCar- 
gaUCP. Value y procedemos a mostrar su estado como se indica a continuación? 


while (hecho < bpProgreso.Maximum) 
( 

hecho += 1; 

// Mostrar progreso 
bpProgreso.Value = hecho; 


} 


Porque la resolución de la barra es baja y perderíamos mucho tiempo de UCP 
asignando valores a su propiedad Value que no modificarían el estado que mues- 
tra la misma. Es mejor asignar a la barra una resolución de 0 a 100 y representar 
el tanto por ciento de la cantidad de tarea hecha, según se indica a continuación: 


while (hecho < numCargaUCP.Value) 
( 
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// Tarea secundaria 
hecho += 1; 
// Mostrar progreso 
tpHecho = (int)(hecho / numCargaUCP.Value * 100); 
1f (tpHecho > bpProgreso.Value) 
bpProgreso.Value = tpHecho; 


Obsérvese que la barra de progreso se rellenará de forma más lenta o más rá- 
pida en función del valor de numCargaUCP. 


A continuación, añada el controlador para el evento Click del botón btCalcu- 
lar y escríbalo como se indica a continuación: 


private void btCalcular_Click(object sender, EventArgs e) 
( 

btCalcular.Enabled = false; 

numCargaUCP.Enabled = false; 

bpProgreso.Value = 0; 

TareaSecundaria(); 


El método btCalcular Click invoca al método TareaSecundaria y se asegura 
de que no se pueda volver a invocar mientras TareaSecundaria no lo permita. 


El método TareaSecundaria define una variable hecho, con un valor inicial 
cero, para conocer en todo momento la cantidad realizada de la tarea secundaria o 
de la que queda por realizar (numCargaUCP. Value — hecho), dato que expresado 
en tanto por ciento por la variable tpHecho se muestra mediante la barra de pro- 
greso. Cuando finaliza habilita los controles btCalcular y numCargaUCP para 
que pueda ser invocado de nuevo. 


private void TareaSecundaria() 
( 
int hecho = 0, tpHecho = 0; 


while (hecho < numCargaUCP.Value) 
( 
// Tarea secundaria 
hecho += 1; 
// Mostrar progreso 
tpHecho = (int)(hecho / numCargaUCP.Value * 100); 
1f (tpHecho > bpProgreso.Value) 
bpProgreso.Value = tpHecho; 
) 
btCalcular.Enabled = true; 
numCargaUCP.Enabled = true; 
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Compile la aplicación, ejecútela y pruebe los resultados. Observará que la eti- 
queta que muestra la hora queda congelada, que la ventana no se puede mover, si 
pone otra ventana encima o la minimiza y restaura su posición la interfaz no se ac- 
tualiza, en general, que el usuario ha perdido el control sobre la aplicación. ¿Por 
qué ha ocurrido esto? 


Cuando se ejecuta la aplicación, se lanza el hilo principal que se encargará de 
procesar la secuencia de eventos que recibe la aplicación. En Windows, cada ven- 
tana y cada control pueden responder a un conjunto de eventos predefinidos. 
Cuando ocurre uno de estos eventos, Windows lo transforma en un mensaje que 
coloca en la cola de mensajes de la aplicación implicada. El hilo principal es el 
encargado de extraer los mensajes de la cola y de procesarlos. Evidentemente, ca- 
da mensaje almacenará la información suficiente para identificar al objeto y ejecu- 
tar de forma síncrona el método que tiene para responder a ese evento. Desde un 
punto de vista gráfico podríamos imaginar este proceso así: 


Cola de 


mensajes | P principal 





Según lo expuesto, ¿qué ocurrirá cuando el hilo principal ejecute el método 
que responde al evento Click del botón “Calcular”? Recuerde que por tratarse de 
una tarea costosa consume mucho tiempo de UCP. Pues sucederá que el hilo prin- 
cipal no podrá atender a otros eventos que se produzcan (mover la ventana, repin- 
tar la ventana, etc.), quedando estos en la cola de la aplicación hasta que finalice 
la respuesta al evento Click del botón “Calcular”, con lo que la interfaz de la apli- 
cación se queda “congelada”. 


La solución al problema planteado pasa por crear un hilo secundario que se 
ejecute en paralelo con el hilo principal y se encargue de realizar esa tarea de 
cálculo mientras el hilo principal atiende al proceso de la cola de mensajes. Según 
esto, la respuesta al evento Click del botón “Calcular” será lanzar un hilo secun- 
dario para que ejecute la tarea de cálculo. 


Clase Thread 


Un proceso es un programa en ejecución. Al crear un proceso del sistema operati- 
vo, este introduce un hilo (hilo principal) para ejecutar el código de dicho proceso. 
A partir de ese punto, pueden crearse y destruirse otros hilos en el dominio de la 
aplicación (hilos secundarios). 
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Un hilo, también llamado subproceso, es un objeto de la clase Thread. El 


constructor de Thread acepta como único parámetro un delegado ThreadStart 
que contiene una referencia al método que se invocará mediante el objeto Thread 
cuando llame a su método Start. Si se llama a Start más de una vez, se lanzará 
una excepción ThreadStateException. 


Continuando con la aplicación, al hacer clic en el botón “Calcular”, el método 


btCalcular Click tendrá ahora que lanzar un hilo secundario que ejecute el proce- 
so de cálculo que definiremos bajo un nuevo método TareaSecundaria, mientras 
el hilo principal sigue procesando los eventos procedentes de la interfaz de usua- 
rio. 


// Hilo para ejecutar una tarea secundaria 
private Thread hiloSecundario; 


private void btCalcular_Click(object sender, EventArgs e) 


( 


} 


btCalcular.Enabled = false; 
numCargaUCP.Enabled = false; 
bpProgreso.Value = 0; 

// Delegado que hace referencia al método 
// que tiene que ejecutar el hilo 
ThreadStart delegadoPS = new ThreadStart(TareaSecundaria); 
// Creación del hilo 

hiloSecundario = new Thread(delegadoPS); 

// Ejecución del hilo 

hiloSecundario.Start(); 








private void Tareasecundaria() 


( 


int hecho = 0, tpHecho = 0; 
while (hecho < numCargaUCP.Value) 
( 
// Tarea secundaria 
hecho += 1; 
// Mostrar progreso 
tpHecho = (int)(hecho / numCargaUCP.Value * 100); 
1f (tpHecho > bpProgreso.Value) 
bpProgreso.Value = tpHecho; 
) 
btCalcular.Enabled = true; 
numCargaUCP.Enabled = true; 


El método Start de Thread envía una solicitud asincrónica al sistema y la 


llamada vuelve inmediatamente, posiblemente antes de que se haya iniciado real- 
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mente el nuevo hilo. Puede utilizar el método ThreadState e IsAlive de Thread 
para determinar el estado del hilo en cualquier momento. 


Si ahora ejecuta la aplicación bajo la configuración Release (Ctrl+-F5) apa- 
rentemente todo ha funcionado como esperábamos, la aplicación ya no se congela. 
Ahora, el esquema de funcionamiento desde un punto de vista gráfico podría ser 
el siguiente: 


Cola de 


Hilo 
mensajes | P principal 21:37:51 





La figura anterior se interpreta de la forma siguiente. La aplicación está en 
ejecución. El mensaje extraído por el hilo principal de la cola de mensajes corres- 
ponde al evento Click sobre el botón btCalcular. El hilo principal crea un hilo se- 
cundario para que se encargue de esta tarea y lo ejecuta. El hilo principal sigue 
procesando los eventos procedentes de la interfaz de usuario. 


Las líneas de código siguientes: 


ThreadStart delegadoPS = new ThreadStartí(TareaSecundaria); 
hiloSecundario = new Thread(delegadoPS); 


pueden sustituirse por esta otra, en la que el objeto ThreadStart se construirá im- 
plícitamente a partir del nombre del método pasado como argumento: 


hiloSecundario = new Thread(TareaSecundaria); 


Vuelva a ejecutar la aplicación bajo la configuración Debug (F5) y obsérvese 
cómo al hacer clic en el botón “Calcular”, lanza una excepción de la clase Sys- 
tem.InvalidOperationException, justo cuando intenta acceder a la propiedad 
Value del control bpProgreso, que dice: 


Operación no válida a través de subprocesos: 
Se accedió al control *nombre_control” desde un subproceso 
distinto al que lo creó. 


La solución a este problema se verá un poco más adelante, en el apartado 
Acceso a controles desde hilos. 
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Resumen de los métodos y propiedades de Thread 


A continuación se resumen algunos de los métodos que se pueden utilizar para 
controlar hilos independientes: 


Start. Inicia la ejecución de un hilo. 

Sleep. Detiene un hilo durante un tiempo determinado. 

Abort. Detiene un hilo cuando alcanza un punto seguro. 

Join. Deja en espera un hilo hasta que finaliza otro hilo diferente. Si se utiliza 
con un valor de tiempo de espera, este método devolverá true cuando el hilo 
finaliza en el tiempo asignado. 


Así mismo, los hilos contienen varias propiedades útiles, algunas de las cuales 


resumimos a continuación: 


IsAlive. Vale true si un hilo se encuentra activo. 

IsBackground. Permite obtener o establecer un valor booleano que indica si 
un hilo es o debería ser un hilo en segundo plano. Los hilos en segundo plano 
son como los hilos en primer plano, excepto que no impiden que finalice un 
proceso. Una vez que concluyen todos los hilos en primer plano de un proce- 
so, la máquina virtual de NET llama al método Abort de los hilos en segundo 
plano activos y finaliza dicho proceso. Para indicar que un hilo está en segun- 
do plano, basta con asignar a su propiedad IsBackground el valor true. Por 
omisión, esta propiedad vale false, indicando que el hilo está en primer plano. 
Name. Permite obtener o establecer el nombre de un hilo. Se utiliza princi- 
palmente con fines de depuración. 

Priority. Permite obtener o asignar a un hilo uno de los siguientes valores de 
prioridad: Highest, AboveNormal, Normal, BelowNormal y Lowest. 

Los sistemas operativos no están obligados a tener en cuenta la prioridad de 
un hilo. 

ThreadState. Describe el estado de un hilo. 


Estados de un hilo 


Cuando se crea un hilo, este pasa al estado Unstarted, estado que conserva hasta 
que cambia al estado Running una vez que haya llamado al método Start (cuan- 
do se invoca Start el hilo seguirá en el estado Unstarted hasta que pueda cambiar 
a Running). En la tabla siguiente se muestran las acciones que pueden provocar 
un cambio de estado, junto con el nuevo estado correspondiente. 
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Acción Nuevo estado resultante 
Otro hilo llama a Thread.Start No cambia 

El hilo responde a Thread.Start y empieza a ejecutarse Running 

El hilo llama a Thread.Sleep WaitSleepJoin 

El hilo llama a Monitor.Wait en otro objeto WaitSleepJoin 

El hilo llama a Thread.Join en otro hilo WaitSleepJoin 
Otro hilo llama a Thread.Interrupt Running 

Otro hilo llama a Thread.Abort AbortRequested 
El hilo responde a un Thread.Abort Aborted 


La propiedad ThreadState de un hilo proporciona el estado actual del mismo. 
Ahora bien, como el valor de Running es cero, para comprobar si un hilo está 
ejecutándose hay que utilizar una expresión como la siguiente: 


if (Chilo.ThreadState Q 
(ThreadState.Stopped | ThreadState.Unstarted)) == 0) 
( 
JAE sido 
) 


ACCESO A CONTROLES DESDE HILOS 


Los controles de los formularios Windows solo pueden ser accedidos desde el hilo 
que los creó. Es decir, no son seguros cuando se manipulan desde hilos diferentes 
al hilo que los creó, porque dos o más hilos manipulando el estado de un control 
pueden conducirlo a un estado inconsistente, pudiendo incluso provocar condicio- 
nes de carrera entre los hilos o interbloqueo, también conocido como abrazo mor- 
tal. Por eso es importante que el acceso a los controles de los formularios 
Windows desde un hilo diferente al que los creó se haga de una forma segura. 


Hay dos formas de acceder a las propiedades de un control desde un hilo de 
forma segura: 


1. Utilizando delegados para habilitar llamadas asíncronas para cada propiedad 
de cada control que tenga que ser accedida de forma segura desde un hilo. 


2. Utilizando el componente BackgroundWorker. 


Delegados 


Un delegado es una clase que puede contener una referencia a un método (para los 
conocedores de C/C++, un delegado realmente es la forma que tiene .NET para 
definir un puntero a una función/método). A diferencia de otras clases, los dele- 
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gados tienen un prototipo y pueden guardar referencias únicamente a los métodos 
que coinciden con su prototipo. La declaración proporciona el prototipo del dele- 
gado y el CLR la implementación. Por ejemplo, la línea siguiente declara el dele- 
gado SetTextDelegate que puede guardar referencias a métodos con un parámetro 
de tipo String. 


private delegate void SetlextDelegate(string paramlext); 


La siguiente línea crea un delegado de la clase SetTextDelegate que almacena 
una referencia al método SetText_ctTextBox1 que debe tener el mismo prototipo 
que SetTextDelegate. 


SetlextDelegate delegado = new SetTextDelegate(SetText_ctlextBoxl); 


La asignación anterior puede escribirse de forma simplificada también así: 


SetlextDelegate delegado = SetText_ctlextBoxl; 


Esta otra línea de código que se muestra a continuación ejecuta el delegado 
especificado en el hilo que creó los controles de la ventana this. 


this.Invoke(delegado, new object[] [texto)):; 


Hay dos formas diferentes de llamar a un método que tiene que acceder a un 
control de la interfaz gráfica del usuario: una síncrona, utilizando Invoke, y otra 
asíncrona, utilizando BeginInvoke. Con la primera, el hilo actual sería bloqueado 
hasta que el delegado sea ejecutado (Invoque realiza un cambio de contexto -un 
hilo detiene su ejecución para permitir que otro hilo se ejecute- y ejecuta el código 
utilizando el mecanismo de exclusión mutua) y con la segunda, una vez efectuada 
la llamada se retorna al hilo actual y se continúa. De lo expuesto se desprende que 
para utilizar estos métodos es necesario declarar un delegado que contendrá el 
método al que se llamará en el contexto del hilo del control. 


Una llamada asíncrona equivale a crear un hilo auxiliar y ejecutar el delegado 
en ese hilo. Si hubiera que obtener el valor retornado por el delegado invocado, lo 
cual es bastante raro, habría que utilizar EndInvoke con el valor de tipo IAsync- 
Result retornado por BeginInvoke, para esperar hasta que el delegado finalice; en 
este caso, EndInvoke bloqueará el subproceso de llamada hasta que finalice esta; 
esto es, usar esta combinación de BeginInvoke y EndInvoke es como llamar a 
Invoke. IAsyncResult representa el estado de una operación asincrónica. Cuando 
sea posible, es aconsejable utilizar BeginInvoke en lugar de Invoke porque evita 
que se puedan producir interbloqueos. 


En general, la utilización de uno u otro método dependerá realmente de las 
necesidades impuestas por el flujo de ejecución de la aplicación. Por ejemplo, si 
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es necesario que la actualización de la interfaz se complete antes de continuar, se 
utilizará Invoke; si no hay tal requisito, se sugiere utilizar BeginInvoke. 


Aplicando esta teoría a nuestra aplicación, por ejemplo, para asignar un valor 
a la propiedad Value de bpProgreso desde el hilo secundario, procederíamos co- 
mo se explica a continuación. 


Definimos el método que permita asignar un valor a la propiedad Value de 
bpProgreso. Para ello, añada a la clase Form] un método con un parámetro que 
almacene el valor que hay que asignar a la propiedad Value de bpProgreso: 


private void SetValue_bpProgreso(int hecho) 
( 
bpProgreso.Value = hecho; 


} 


Definimos el delegado que habilite la llamada sincrona o asíncrona al método 
anterior. Para ello, añada como miembro de la clase Form] un tipo delegado, 
SetValueDelegate, con la misma firma que el método que se invocará a través de 
un objeto de este tipo, esto es, con la firma de SetValue _bpProgreso: 


private delegate void SetValueDelegate(int prValue); 


Modifique el método SetValue bpProgreso para que el acceso a la propiedad 
Value del control bpProgreso sea seguro. Para que esta operación sea segura solo 
debe permitirse realizarla desde el hilo que creó ese control; en otro caso, como 
vimos anteriormente, se lanzaría una excepción InvalidOperationException: 


private void SetValue_bpProgreso(int hecho) 
( 
1f (bpProgreso.InvokeRequired) 
( 
// Acceso seguro a la propiedad Value de bpProgreso 
// desde un hilo 
SetValueDelegate delegado = 
new SetValueDelegate(SetValue_bpProgreso); 
bpProgreso.Invoke(delegado, new object[] [ hecho )); 
) 
else 
bpProgreso.Value = hecho; 


La propiedad InvokeRequired de un control devuelve true si el hilo que ha 
invocado al método que se está ejecutando (SetValue bpProgreso en este caso) no 
se corresponde con el hilo que creó ese control (bpProgreso en este ejemplo). 
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El método anterior muestra un patrón para hacer llamadas seguras sobre un 
control de un formulario Windows. Si el hilo que ejecuta este método es diferente 
del hilo que creó el control, este método creará un delegado de tipo SetValueDe- 
legate y se hace a sí mismo una llamada síncrona utilizando el método Invoke (o 
asíncrona utilizando BeginInvoke) pasando como segundo argumento el valor 
que hay que asignar a la propiedad del control. En el caso de que el hilo que eje- 
cuta este método sea el mismo que el hilo que creó el control, entonces la propie- 
dad del control será accedida directamente. 


El método Invoke ejecuta el delegado especificado en el hilo que posee el 
identificador del control (control.Invoke) o de la ventana que lo contiene 
(this.Invoke), con la lista de argumentos especificada. Si el identificador buscado 
no se encontrara, el método Invoke lanzará una excepción. Ídem para el método 
BeginInvoke. 


El método SetValue bpProgreso será invocado por el método correspondien- 
te al hilo secundario, cada vez que se necesite establecer la propiedad Value de 
bpProgreso, como se puede observar a continuación: 


private void TareaSecundaria() 
( 
int hecho = 0, tpHecho = 0; 


while (hecho < numCargaUCP.Value) 
( 

// Tarea secundaria 

hecho += 1; 

// Mostrar progreso 

tpHecho = (int)(hecho / numCargaUCP.Value * 100); 

1f (tpHecho > bpProgreso.Value) 

SetValue_bpProgreso(tpHecho); 

) 
SetEnabled_btCalcular(true); 
SetEnabled_numCargaUCP(true); 


Como aclaración sobre cómo trabajan los delegados, analicemos, por ejem- 
plo, la llamada que realiza TareaSecundaria a SetValue_bpProgreso. Esta llama- 
da, como se puede observar, se ejecuta desde el hilo secundario e inicia la 
ejecución de SetValue bpProgreso. La propiedad InvokeRequired del control 
bpProgreso devuelve true porque el hilo no es el que creó el control (quien lo 
creó fue el hilo principal). Se crea un delegado que encapsula una referencia al 
mismo método SetValue bpProgreso y se llama a Invoke para ejecutar el delega- 
do con el argumento hecho, lo que hace que se inicie otra vez la ejecución de 
SetValue bpProgreso, pero ahora desde el hilo principal, el que creó el control 
(Invoke ejecuta el delegado especificado en el hilo que posee el identificador del 
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control; control.Invoke), por lo tanto, ahora la propiedad InvokeRequired del 
control bpProgreso devuelve false, lo que hará que se acceda directamente a la 
propiedad Value del control para asignarle el valor hecho. Delegando en el hilo 
principal a la hora de actualizar la interfaz, se evita el problema del acceso concu- 
rrente a un recurso compartido desde dos hilos diferentes. 


private void SetValue_bpProgreso(int hecho) 
( 
1f (bpProgreso.InvokeRequired) 
( 
SetValueDelegate delegado = 
new SetValueDelegate(SetValue_bpProgreso); 
bpProgreso.Invoke(delegado, new object[] [ hecho )); 
) 
else 
bpProgreso.Value = hecho; 





Como se puede observar en el método TareaSecundaria, el proceso explicado 
habría que repetirlo para acceder a la propiedad Enabled de los botones btCalcu- 
lar y niumCargaUCP. El desarrollo completo lo puede ver en el CD de este libro. 


El delegado puede ser también una instancia de EventHandler, en cuyo caso 
el parámetro remitente hará referencia a este control y el parámetro de evento ten- 
drá el valor EventArgs.Empty, y también puede ser un objeto MethodInvoker o 
cualquier otro delegado que tome una lista de parámetros vacía. Una llamada a un 
delegado EventHandler o MethodInvoker será más rápida que una llamada a 
otro tipo de delegado. Por ejemplo, podemos realizar otra versión de la aplicación 
anterior utilizando ahora un objeto MethodInvoker: 


private int tpHecho; 


private void SetValue_bpProgreso() 
( 

bpProgreso.Value = tpHecho; 
) 


private void SetEnabled_btCalcular() 
( 
btCalcular.Enabled = true; 


} 





private void SetEnabled_numCargaUCP() 
{ 

numCargaUCP.Enabled = true; 
) 
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private void TareaSecundaria() 


MethodInvoker delegado; 
delegado = new MethodInvoker(SetValue_bpProgreso); 





while (hecho < numCargaUCP.Value) 
( 
// Tarea secundaria 
hecho += 1; 
// Mostrar progreso 
tpHecho = (int)(hecho / numCargaUCP.Value * 100); 
1f (tpHecho > bpProgreso.Value) 
bpProgreso.Invoke(delegado); 
) 


delegado = new MethodInvoker(SetEnabled_btCalcular); 
btCalcular.Invoke(delegado); 
delegado = new MethodInvoker(SetEnabled_numCargaUCP); 
numCargaUCP.Invoke(delegado); 


La restricción que tiene la utilización del delegado MethodInvoker es que el 
método referenciado no tiene parámetros. 


Vuelva a ejecutar la aplicación bajo la configuración Release (Ctrl+F5) y cie- 
rre el formulario antes de que la tarea secundaria finalice. Si ahora abre el admi- 
nistrador de tareas, observará en la lista de procesos que ApMultiproceso.exe no 
ha finalizado. ¿Qué ha sucedido? Pues que al interrumpir la tarea que estaba reali- 
zando el hilo secundario de una forma incontrolada, el hilo primario no tiene co- 
nocimiento de su finalización y sigue esperando por su finalización. Véase más 
adelante el apartado Detener un hilo de forma controlada. 


Componente BackgroundWorker 


Otra forma de garantizar que una aplicación con una interfaz gráfica sea sensible a 
las acciones del usuario, independientemente de que esta ejecute operaciones que 
consuman grandes cantidades de tiempo como, por ejemplo, descargar o cargar 
imágenes u otros ficheros, llamadas a servicios web, operaciones locales comple- 
jas, transacciones con bases de datos, o accesos al sistema de ficheros, entre otras, 
es utilizando el componente Background Worker del espacio de nombres Sys- 
tem.ComponentModel. Este componente está disponible en el panel Componen- 
tes de la caja de herramientas. 
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El componente BackgroundWorker permite ejecutar de forma asíncrona y 
en segundo plano operaciones que consumen cantidades grandes de tiempo en un 
hilo diferente al hilo principal de la aplicación. Para ello, basta con indicar al 
componente cuál es el método trabajador (el que ejecuta esa operación costosa) y, 
a continuación, llamar al método RunWorkerAsync. Este método puede tomar 
parámetros que pueden después ser pasados al método trabajador. 


Cuando se llama al método RunWorkerAsync se genera el evento DoWork. 
El hilo que llama, generalmente el hilo principal, continuará ejecutándose nor- 
malmente, mientras el método trabajador se ejecuta de forma asíncrona como res- 
puesta al evento DoWork. Cuando el método trabajador termine, el componente 
Background Worker avisará al hilo que lo llamó generando el evento RunWor- 
kerCompleted, que opcionalmente contiene los resultados de la operación. 


Como ejemplo, podemos realizar otra versión de la aplicación anterior, utili- 
zando un componente BackgroundWorker. Partiendo de la aplicación original 
con un hilo secundario, arrastre sobre el formulario un componente Back- 
ground Worker desde el panel Componentes de la caja de herramientas y deno- 
mínelo, por ejemplo, hiloTrabajador. 


Ejecutar una tarea de forma asíncrona 


La tarea que deseamos ejecutar de forma asíncrona, en un hilo independiente, se 
inicia invocando al método RunWorkerAsync del objeto BackgroundWorker: 


private void btCalcular_Click(object sender, EventArgs e) 
( 
// Inhabilitar controles. Se habilitarán de nuevo cuando se 
// genere el evento RunWorkerCompleted 
btCalcular.Enabled = false; 
numCargaUCP.Enabled = false; 
bpProgreso.Value = 0; 


// Iniciar el hilo secundario encapsulado por 
// el objeto BackgroundWorker 
hiloTrabajador.RunWorkerAsync():; 


El método RunWorkerAsync genera el evento DoWork. Por lo tanto, utili- 
zaremos el controlador de este evento para ejecutar el código correspondiente a la 
tarea propia del hilo. El controlador de este evento tiene un parámetro, un objeto 
de la clase DoWorkEventArgs, que tiene dos propiedades: Argument y Result. 
La primera contendrá el valor del parámetro de tipo Object que opcionalmente se 
puede especificar cuando se invoca al método RunWorkerAsync, y la segunda se 
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utiliza para asignar el resultado final de la operación, el cual debería ser recupera- 
do cuando el evento RunWorkerCompleted sea controlado. 


private void hiloTrabajador_DoWork(object sender, DoWorkEventArgs e) 
( 
BackgroundWorker hiloTr = (BackgroundWorker)sender; 
TareaSecundaria(hiloTr, e); 


1 
J 


En lugar de hacer uso directamente del objeto hiloTrabajador, hemos obteni- 
do una referencia al mismo a través del parámetro sender. De esta forma, cuando 
tengamos múltiples componentes BackgroundWorker en un formulario, asegu- 
ramos que la referencia obtenida será al objeto que generó el evento. 


También, cuando invocamos al método trabajador (TareaSecundaria) necesi- 
tamos pasar la referencia al componente Background Worker así como los datos 
del evento (parámetro e) para desde el mismo poder facilitar información sobre el 
progreso de la tarea y su posible cancelación. 


private void TareaSecundaria(BackgroundWorker hiToTr, DoWorkEventArgs E) 
( 
int hecho = 0, tpHecho = 0; 


while (hecho < numCargaUCP.Value) 
( 

// Tarea secundaria 

hecho += 1; 


// Mostrar progreso 

tpHecho = (int)(hecho / numCargaUCP.Value * 100); 

1f (tpHecho > bpProgreso.Value) 

{ 
// La llamada a ReportProgress genera el evento ProgressChanged 
hiloTr.ReportProgress(tpHecho); 

) 

// ¿Se ha cancelado la operación? 

if (hiloTr.CancellationPending) 

[ 
e.Cancel = true; 
break; 

) 





La información sobre el progreso de la tarea la damos invocando al método 
ReportProgress del componente BackgroundWorker y la de su posible cance- 
lación por medio de su propiedad CancellationPending. Cada vez que se invoca 
a ReportProgress se genera el evento ProgressChanged. 
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Notificar el progreso a la interfaz gráfica del usuario 


Para dar información sobre el progreso de la tarea en segundo plano, lo primero 
que hay que hacer es poner la propiedad WorkerReportsProgress de Back- 
ground Worker a true (esto se puede lograr desde la ventana de propiedades) y 
después añadir el controlador del evento ProgressChanged. El parámetro de tipo 
ProgressChangedEventArgs de este controlador define la propiedad Progress- 
Percentage que almacena la información sobre el progreso, la cual es facilitada 
por el método ReportProgress del componente. Esta información es la que po- 
demos asignar directamente a la barra de progreso. 


private void hiloTrabajador_ProgressChanged(object sender, Pro- 
gressChangedEventArgs e) 
( 

// Mostrar progreso 

bpProgreso.Value = e.ProgressPercentage; 


} 
Recuperar el estado después de la finalización de la tarea 


El evento RunWorkerCompleted es generado en tres circunstancias diferentes: 
cuando finaliza la tarea en segundo plano, cuando es cancelada, o cuando lanza 
una excepción. 


private void hiloTrabajador_RunWorkerCompleted( 
object sender, RunWorkerCompletedEventArgs e) 
{ 
// Primero se verifica si lanzó una excepción 
ir (oros 1= mui) 
// Ocurrió un error 
MessageBox.Show(e.Error.Message); 
else if (e.Cancelled) 
// Operación cancelada 
MessageBox.Show("Operación cancelada"); 
else 
{ 
// La operación finalizó correctamente 
btCalcular.Enabled = true; 
numCargaUCP.Enabled = true; 





) 
) 


Como puede observarse, el argumento e tiene las propiedades Error, Cance- 
lled, y Result, las cuales son utilizadas para obtener el estado de la operación y su 
resultado final. 
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Cancelación anticipada 


Para cancelar la tarea en segundo plano de forma controlada, primero hay que po- 
ner la propiedad WorkerSupportsCancellation de Background Worker a true. 
Cumplido este requisito, para cancelar la tarea en segundo plano hay que invocar 
al método CancelAsync del componente. 


private void Forml_FormClosing(object sender, FormClosingEventArgs e) 


( 
// Cancelar la operación asíncrona 
hiloTrabajador.CancelAsync(); 


// Otras operaciones 


} 


La ejecución de CancelAsyne pone la propiedad CancellationPending de 
BackgroundWorker a true, propiedad que verificaremos en el hilo trabajador, 
como ya hemos visto anteriormente. Cuando su valor sea true, asignaremos a la 
propiedad Cancel de DoWorkEventArgs el valor true y abandonamos la ejecu- 
ción del método. 


private void TareaSecundaria(BackgroundWorker hiloTr, DoWorkEventArgs e) 
( 
Dali a 
if (hiloTr.CancellationPending) // ¿Se ha cancelado la operación? 
( 
e.Cancel = true; 
break; 
) 
) 


MECANISMOS DE SINCRONIZACIÓN 


Cuando se ejecuta un hilo hay que tener en cuenta la posible existencia de otros 
hilos que se ejecuten concurrentemente, especialmente si ese hilo comparte de- 
terminados recursos con estos otros. Por ello, y dado que los hilos se ejecutan en 
el mismo espacio de memoria dentro del proceso del que son “subprocesos”, hay 
que poner especial atención para evitar que dos hilos accedan a un recurso com- 
partido al mismo tiempo. Este recurso compartido, usualmente, será un objeto y 
de no coordinar el acceso al mismo por los distintos hilos, el objeto puede termi- 
nar teniendo un estado no válido. 


Además, la ejecución de un hilo puede depender del resultado de otros hilos; 
es el caso de hilos cooperantes, cooperación que se realizará a través de recursos 
compartidos. 
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Resumiendo, cuando en una aplicación se ejecuten varios hilos concurrente- 
mente, en muchos casos será necesario utilizar mecanismos de sincronización pa- 
ra que los distintos hilos coordinen su ejecución. 


La infraestructura de la máquina virtual de .NET proporciona diversas estra- 
tegias para sincronizar el acceso a objetos y miembros estáticos: 


1. Contextos sincronizados. Se puede utilizar el atributo SynchronizationAttri- 
bute para habilitar la sincronización automática y simple de objetos Context- 
BoundObject. 


2. Método Synchronized. Algunas clases, como Hashtable y Queue, propor- 
cionan un método Synchronized static que devuelve un contenedor seguro 
para la ejecución de hilos. 


3. Regiones de código sincronizado. Se puede utilizar la clase Monitor o la sen- 
tencia lock para sincronizar solo el bloque de código necesario. 


4. Sincronización manual. Se pueden utilizar varios objetos de sincronización 
para crear mecanismos de sincronización propios. 


Objetos de sincronización 


La plataforma .NET proporciona varios objetos de sincronización que podemos 
utilizar para controlar las interacciones de los hilos y evitar las condiciones de ca- 
rrera y otras anomalías que se puedan producir. Estos pueden dividirse en tres ca- 
tegorías: exclusión mutua, señalización e interbloqueo. No obstante, algunos 
mecanismos de sincronización podrán ser utilizados en más de una categoría. 
También es importante recordar que la sincronización es cooperativa. 


A continuación se resumen algunas de las clases de objetos de .NET Frame- 
work que se pueden utilizar para sincronizar la ejecución de varios hilos que com- 
parten recursos comunes: 


e Monitor. Un objeto de esta clase expone la capacidad de sincronizar el acce- 
so a una región de código mediante la obtención y liberación de un bloqueo 
sobre un objeto concreto con los métodos Monitor.Enter, Monitor.TryEn- 
ter y Monitor.Exit. Una vez obtenido el bloqueo que habilita al hilo para eje- 
cutar la región de código crítica, puede utilizar los métodos Monitor.Wait 
para liberar el bloqueo, si se mantiene, y espera su notificación, y Moni- 
tor.Pulse y Monitor.PulseAll para avisar al siguiente hilo en la cola de la co- 
la de espera para continuar. 
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e  Mutex (exclusión mutua). Son objetos de sincronización que solo pueden ser 
propiedad de un solo hilo a la vez. Cuando un hilo necesita acceso a un recur- 
so solicita la propiedad del objeto de exclusión mutua. Si está libre lo adquie- 
re y accede al recurso y si está adquirido por otro hilo, espera a poder adqui- 
rirlo antes de utilizar el recurso. En este sentido, el método WaitOne hace 
que el hilo que lo invoque espere a poseer un objeto Mutex y el método Re- 
leaseMutex permite liberarlo. 


A diferencia de la clase Monitor, un Mutex puede ser local o global. Las ex- 
clusiones mutuas globales son visibles en todo el sistema operativo y se pue- 
den utilizar para sincronizar hilos en varios procesos. 


e Semaphore. Un semáforo a diferencia de un objeto de exclusión mutua puede 
controlar el acceso a varios recursos por distintos hilos simultáneamente. Para 
entrar en el semáforo, los hilos llaman al método WaitOne y para liberarlo 
llaman al método Release. 


e  EventWaitHandle. Esta clase permite a los hilos comunicarse con otros hilos 
por señalización. Un objeto EventWaitHandle es en realidad un controlador 
de espera de eventos, en estado señalizado o no señalizado. Pasará al estado 
señalizado para liberar uno o más hilos que están esperando por un recurso. 
Una vez esté en el estado señalizado, pasará a no señalizado de forma automá- 
tica o manual. 


e  AutoResetEvent. Esta clase es una particularización de su clase base Event- 
WaitHandle. Un objeto AutoResetEvent pasará automáticamente al estado 
no señalizado después de que un hilo que estaba bloqueado esperando por un 
recurso haya sido liberado para que accediera al mismo. 


e  ManualResetEvent. Esta clase es una particularización de su clase base 
EventWaitHandle. Un objeto ManualResetEvent permanecerá señalizado 
hasta que invoque a su método Reset. El método Reset cambia el estado de 
un objeto ManualResetEvent a no señalizado, ocasionando que los hilos que 
compitan por un recurso se bloqueen, y el método Set lo cambia a señalizado, 
permitiendo a uno o más hilos que están esperando por un recurso acceder al 
mismo. 


e  Interlocked. Ofrece operaciones atómicas para las variables compartidas por 
varios hilos. 


e ReaderWriterLock. Define el bloqueo que implementa las semánticas de es- 
critura única y de lectura múltiple. 


e Timer. Ofrece un mecanismo para ejecutar tareas a intervalos específicos. 
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e WaitHandle. Esta clase es abstracta y es la clase base para los objetos de sin- 
cronización. Se derivan de esta clase Mutex, EventWaitHandle y Sema- 
phore. 


Secciones críticas 


Una sección crítica es un segmento de código en el que se actualizan objetos de 
datos comunes a más de un hilo. Una forma sencilla de evitar los problemas que 
pudieran surgir por el acceso simultáneo de dos o más hilos a ese segmento de 
código es utilizando el mecanismo de exclusión mutua. Este mecanismo garantiza 
que la sección crítica será ejecutada solo por un hilo cada vez y se puede imple- 
mentar utilizando cerrojos (lock) o monitores (Monitor). 


La forma más simple de crear un cerrojo es utilizando la sentencia lock (Syne- 
Lock en Visual Basic). Esta sentencia bloquea el acceso a la sección crítica de 
código. Un hilo que acceda a la sección crítica cuando el cerrojo está echado, por- 
que la está ejecutando otro hilo, se bloquea hasta que el cerrojo sea liberado. Por 
ejemplo, suponga que el siguiente código tiene que ser ejecutado por varios hilos 
para que, actuando sobre la variable i, produzcan una cuenta única, esto es, sin 
que se produzcan repeticiones. Para obtener los resultados esperados, dicho códi- 
go debe ser definido en una sección crítica así (la solución completa puede verla 
en el apartado de Ejercicios resueltos): 


lock (m_Form) // m_fForm es el objeto en el que 
( // se va a adquirir el bloqueo 

// 1. Lectura del dato 
int 1 = m_Form.varX; 
// 2. Proceso 
// Se produce un cambio de contexto 
Thread.Sleep(DateTime.Now.Millisecond % 100); 
1++; 
// 3. Escribir el resultado 
_Form.varX = i; 
// Mostrar el valor de varX en la lista de Forml 
item = "Hilo " + m_idHilo + ": " + m_Form.varX; 
_Form.Setltem_1sHilos(item); 











En este ejemplo, de no existir el bloqueo, la cuenta no sería correcta ya que 
probablemente se repetirían muchos números. ¿Por qué? Porque un hilo en ejecu- 
ción podría ser interrumpido después de cualquier línea de código. Por ejemplo, 
suponga un hilo ejecutando el código anterior y otro esperando a poder ejecutarlo. 
Se produce un cambio de contexto antes de incrementar la i; esto significa que el 
hilo en ejecución la interrumpe y que el otro hilo que estaba esperando inicia su 
ejecución leyendo el dato, procesándolo y escribiéndolo. Suponga que en este ins- 
tante se produce otro cambio de contexto que hace que el hilo que interrumpió su 
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ejecución la reanude; evidentemente, producirá el mismo resultado que el ante- 
rior, lo cual no se corresponde con la cuenta esperada. 


La sentencia lock establece un bloqueo de exclusión mutua sobre el objeto a 
sincronizar. Este objeto será bloqueado por el hilo que desea ejecutar la sección 
crítica y el bloqueo será liberado cuando finalice la ejecución de la misma, mo- 
mento en el que el objeto podrá ser bloqueado por otro hilo que esté esperando pa- 
ra ejecutar esa sección crítica. El objeto se utiliza para definir el ámbito del 
bloqueo (en el ejemplo anterior, el ámbito del bloqueo se limita al ámbito del ob- 
jeto m_Form), por eso se recomienda definirlo private con el fin de evitar que 
cualquier otro código de la aplicación que tuviera acceso al mismo, en el caso de 
ser público, comparta el mismo bloqueo, lo que podría crear situaciones de inter- 
bloqueo, en las que dos o más hilos esperan a que se libere el mismo objeto. La 
sentencia lock ha sido implementada utilizando los métodos Enter y Exit de un 
objeto Monitor, y utilizando la sentencia try...catch...finally para asegurar que 
el bloqueo es liberado. A continuación se muestra un ejemplo de cómo se hace es- 
to: 


try 
( 
do 
( 
Monitor.Enter(m_Form); // m_Form es el objeto de sincronismo 
// Sección crítica 
Monitor.Exit(m_Form):; 
) 
while (true); 
) 
catch (Exception ex) 
( 
Debug.Writeline("Error inesperado en el hilo " + m_idHilo); 
Debug.WriteLine(ex.Message):; 
) 
finally 
( 
Monitor.Exit(m_Form); 


} 
Evidentemente, la clase Monitor del espacio de nombres System.Threading 


proporciona además otra funcionalidad que puede utilizarse junto con la sentencia 
lock, según vimos de forma resumida anteriormente. 


Controladores de espera 


Hemos visto que un bloqueo (o un monitor) es útil para evitar la ejecución simul- 
tánea de bloques de código por varios hilos, pero este mecanismo no permite que 
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un hilo comunique un evento a otro hilo. Esto requiere usar controladores de espe- 
ra, que son objetos que notifican a un hilo mediante señales algo que otro hilo le 
quiere comunicar. Por lo tanto, los controladores de espera serán utilizados por los 
hilos para notificar a otros hilos un evento. De este modo, los demás hilos deberán 
esperar, bloqueándose, a que se dé tal evento. 


Los controladores de espera tienen dos estados: señalizado y no señalizado. El 
controlador de espera se encontrará en el estado señalizado cuando no lo utilice 
ningún hilo. Si está siendo utilizado por algún hilo, su estado será no señalizado. 
Se podrían comparar con los taxis en nuestra vida cotidiana: llevan la luz verde 
encendida cuando están libres (no están siendo utilizados); en otro caso, la luz 
verde está apagada. 


La clase WaitHandle representa los objetos de sincronización de la máquina 
virtual NET que permiten operaciones de espera. Es una clase abstracta y entre 
sus clases derivadas están las siguientes: 


e  Mutex y Semaphore, que ya fueron mencionadas. 


e La clase EventWaitHandle y sus clases derivadas, AutoResetEvent y Ma- 
nualResetEvent. La clase EventWaitHandle define controladores de espera 
de eventos. 


Un hilo puede solicitar la propiedad de un controlador de espera llamando a 
uno de los métodos WaitOne, WaitAny o WaitAll. Estos métodos definidos en 
la clase WaitHandle son llamados para determinar si un hilo puede continuar eje- 
cutándose o, por el contrario, queda bloqueado. A continuación se resume la ac- 
ción que ejecutan cuando un hilo los invoca: 


e WaitOne. Bloquea el hilo actual hasta que el estado del objeto WaitHandle 
implicado en la llamada pase a señalizado (Set) o hasta que pase un tiempo. 
Opcionalmente, puede especificar dos parámetros: un entero para medir el in- 
tervalo de tiempo (—1 indica un tiempo infinito) y un bool (este parámetro no 
tiene ningún efecto en casi todos los casos). Devuelve true cuando el objeto 
WaitHandle actual pase a señalizado; en otro caso devuelve false. 


e WaitAny. Acepta como argumento una matriz de controladores de espera y 
hace que el hilo que llama espere hasta que el estado de uno de los controla- 
dores de espera especificados llame a Set. Devuelve el índice de la matriz del 
objeto WaitHandle señalizado; en otro caso devuelve WaitTimeout. 


e WaitAll. Acepta como argumento una matriz de controladores de espera y 
hace que el hilo que llama espere hasta que el estado de todos los controlado- 
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res de espera especificados llamen a Set. Devuelve true cuando todos los ob- 
jetos WaitHandle pasen a señalizado; en otro caso devuelve false. 


La clase EventWaitHandle derivada de WaitHandle hereda los métodos de 
esta y define otros como Set y Reset: 


e Set. Define como señalizado el estado de un controlador de espera de eventos 
especifico y reanuda la ejecución de los hilos en espera. 


e Reset. Define como no señalizado el estado de un controlador de espera de 
eventos específico. 


Un objeto EventWaitHandle es un controlador de espera de eventos, en es- 
tado señalizado o no señalizado (se utiliza el término “evento” porque la acción de 
señalizar indica a los hilos en espera que se ha producido un evento). Pasará al es- 
tado señalizado para liberar uno o más hilos que están esperando por un recurso. 
Una vez esté en el estado señalizado, pasará a no señalizado de forma automática 
cuando se trate de un objeto AutoResetEvent o manual cuando se trate de un ob- 
jeto ManualResetEvent. 


Supongamos un hilo que invoca a WaitOne por medio de un objeto AutoRe- 
setEvent y que este objeto se encuentra en el estado no señalizado. El hilo se blo- 
quea en espera de que el hilo que controla el recurso en ese momento indique que 
dicho recurso está disponible mediante una llamada a Set. Una llamada a Set in- 
dica a AutoResetEvent que libere un hilo en espera. AutoResetEvent permanece 
señalizado hasta que se libera un único hilo en espera y, a continuación, vuelve 
automáticamente al estado de no señalizado. Si no hay ningún hilo en espera, el 
estado permanece señalizado indefinidamente. 


El estado inicial de un objeto AutoResetEvent se puede controlar pasando un 
valor bool al constructor: true objeto señalizado y false no señalizado. 


A continuación, utilizaremos la teoría expuesta, concretamente los controla- 
dores de espera de eventos, para detener un hilo de forma controlada. Cuando ex- 
plicamos delegados y los implementamos en nuestra aplicación ejemplo para 
poder acceder de forma segura a las propiedades de los controles del formulario, 
observamos que si deteníamos la aplicación antes de que el hilo secundario termi- 
nara, el hilo primario no finalizaba porque, al no tener conocimiento de la finali- 
zación del secundario, seguía esperando por este hecho. Además, una finalización 
sin controlar de una tarea puede conducirnos a errores en los resultados. 
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DETENER UN HILO DE FORMA CONTROLADA 


Cuando se cierra una aplicación y hay hilos secundarios que aún no han finaliza- 
do, es probable que surjan problemas si estos no se detienen controladamente. A 
continuación se explica cómo realizar este proceso correctamente. En este ejerci- 
cio utilizaremos llamadas BeginInvoke excepto para actualizar la barra de pro- 
greso; en este caso utilizaremos Invoke para esperar a que la barra se actualice. 
Los pasos a seguir son los siguientes: 


1. 


Cuando se vaya a cerrar la aplicación, el hilo principal informará a los hilos 
secundarios de que deben detenerse. Para informar de esta acción, utilizará un 
controlador de espera de eventos; por ejemplo, controladorPararHiloSecun- 
dario. 


Una vez el hilo principal haya informado a los hilos secundarios de que deben 
detenerse, el hilo principal esperará a que estos le informen de que han para- 
do, pero permitiendo procesar eventos, lo cual hace invocando al método Ap- 
plication.DoE vents. Por ejemplo, el hilo principal está controlando un evento 
FormClosing durante un tiempo no definido, esperando a que los hilos se- 
cundarios finalicen; para permitir controlar otros eventos durante este tiempo, 
hay que invocar a DoEvents; piense que un evento no se controla hasta que 
no finalice el evento actual que se está controlando. En el caso que nos ocupa, 
para evitar interbloqueos haremos una espera finita, ya que el hilo secundario 
hace llamadas a Invoke que se procesan en el hilo principal. 


Cada hilo secundario verificará en cada iteración si le ha sido solicitado que 
se detenga, en cuyo caso se realizarán las operaciones de limpieza necesarias 
e informará al hilo primario de que ha parado, utilizando para ello otro contro- 
lador de espera de eventos; por ejemplo, controladorHiloSecundarioParado. 


public partial class Forml : Form 


( 


// Hilo para ejecutar una tarea secundaria 
private Thread hiloSecundario; 


// Controladores de espera de eventos: 

// "Parar hilo" e "Hilo parado" 

private ManualResetEvent controladorPararHiloSecundario; 
private ManualResetEvent controladorHiloSecundarioParado; 


// Delegado para acceder a la propiedad Value de bpProgreso 
private delegate void SetValueDelegate(int prValue); 


// Delegado para acceder a la propiedad Enabled de los botones 




















private delegate void SetEnabledDelegate(bool prEnabled); 
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public Forml() 


( 


) 


InitializeComponent(); 


private void Temporizador_Tick(object sender, EventArgs e) 


( 
) 


etHora.Text = Datelime.Now.ToLonglimeString(); 


private void TareaSecundaria() 


( 


) 





int hecho = 0, tpHecho = 0; 
while (hecho < numCargaUCP.Value) 


( 


) 


// Tarea secundaria 

hecho += 1; 

// Mostrar progreso 

tpHecho = (int)(hecho / numCargaUCP.Value * 100); 

1f (tpHecho > bpProgreso.Value) 
SetValue_bpProgreso(tpHecho); 

I LEl Milo principal ha solicitado parar? 

// WaitOne devolverá true cuando el estado del controlador 

// pase a señalizado 

if (controladorPararHiloSecundario.WaitOne(0, false)) 

( 
// Tareas de limpieza. 
// Informar al hilo principal de que este hilo ha parado 
// cambiando el estado de este controlador de espera a 
// señalizado. 
SetEnabled_btCalcular(true); 
SetEnabled_numCargaUCP(true); 
controladorHiloSecundarioParado.Set(); 
return; 


) 


SetEnabled_btCalcular(true); 
SetEnabled_numCargaUCP(true):; 





private void SetValue_bpProgreso(int hecho) 


( 





1f (bpProgreso.InvokeRequired) 


( 


) 


// Acceso seguro a la propiedad Value de bpProgreso desde un hilo 
SetValueDelegate delegado = 

new SetValueDelegate(SetValue_bpProgreso); 
bpProgreso.Invoke(delegado, new object[] [ hecho )); 


else 
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bpProgreso.Value = hecho; 
} 


private void SetEnabled_btCalcular(bool b) 
{ 

Fl oana 
} 


private void SetEnabled_numCargaUCP(bool b) 
{ 

// 
) 


private void btCalcular_Click(object sender, EventArgs e) 
{ 

btCalcular.Enabled = false; 

numCargaUCP.Enabled = false; 

bpProgreso.Value = 0; 





// Creación del hilo 
hiloSecundario = new Thread(TareaSecundaria); 
// Ejecución del hilo 
hiloSecundario.Start(); 
) 


private void Forml_FormClosing(object sender, FormClosingEventArgs e) 
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// esta razón, se espera por controladorHiloSecundarioParado 

// (un tiempo apropiado y de paso damos tiempo al hilo 

// secundario) y se permite procesar otros eventos. Estos 

// eventos pueden incluir llamadas Invoke. 

WaitHandle.WaitAll((new ManualResetEventL[] 

{ controladorHiloSecundarioParado )), 100, false) 
Application.DoEvents(); // procesar otros eventos 

) 

hiloSecundario = null; 

peturi True: 


) 





} 


La llamada a WaitAll es para que la espera no sea activa (es decir, para no 
ocupar al procesador mientras esperamos). Esto se podría conseguir también 
usando una llamada a Sleep: 


while (hiloSecundario.IsAlive) 
( 
Thread.Sleep(100); 
Application.DoEvents(); 
) 


Pero esta opción es peor porque siempre esperamos 100 milisegundos, mien- 
tras que con WaitAll solo tenemos que esperar los 100 milisegundos completos 
en caso de que la señal no se active durante la espera. 


EJERCICIOS RESUELTOS 


1. Realizar una aplicación que presente una interfaz gráfica como la de la figura 
mostrada a continuación. 


La aplicación visualizará en una lista una cuenta 0, 1, 2..., coincidente con el 
segundero de un reloj, en la que participarán uno o más hilos secundarios en se- 
gundo plano. 
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a4 Sincronización de hilos, 





Hilo 0: 40 
Hilo 4: 41 
Hilo 1: 42 
Hilo 3: 43 
Hilo 2: 44 
Hilo 0: 45 
Hilo 4: 46 
Hilo 1: 47 
Hilo 3: 48 
Hilo 2: 49 
Hilo 0: 50 
Hilo 4: 51 
Hilo 1: 52 
Hilo 3: 53 
Hilo 5: 54 
Hio 2:55 











El valor actual de la cuenta será almacenado en una variable miembro pública 
del formulario llamada varX. Esa variable será incrementada por hilos secundarios 
en segundo plano; tantos como se quieran crear. Cada vez que el usuario haga clic 
en el botón “Iniciar un hilo” se generará un nuevo hilo contador. 


Cada hilo contador será de la clase Contador. Esta clase almacenará en un 
atributo una referencia al formulario para poder acceder a la variable miembro 
pública varX, en otro almacenará el identificador del hilo (0, 1, 2...), y presentará 
una interfaz formada por un constructor con dos argumentos (referencia al formu- 
lario e identificador del hilo) y por el método TareaHilo que ejecutará cada hilo 
en segundo plano. Este método realizará el conteo segundo a segundo y lo mostra- 
rá en una lista sobre el formulario indicando qué hilo, de los que están en ejecu- 
ción, ha sido el que contó en ese instante. 


using System.Threading; 
using System.Diagnostics; 


public partial class Forml : Form 
( 
// Delegado para acceder a la propiedad Items de lsHilos 
private delegate void SetltemListDelegate(string prltems); 
// Identificador (0, 1, 2,...) del siguiente Contador que se cree 
private int ¡idHilo; 
// Variable miembro compartida por todos los hilos 
public int varX; 


public Forml() 
( 

InitializeComponent(); 
} 


private void btIniciarHilo_Click(object sender, EventArgs e) 
{ 
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} 


) 


pu 
( 


) 


// Construir un objeto nuevo de la clase Contador 
Contador nuevoContador = new Contador(this, idHilo); 
idHilo += 1; 

// Crear un hilo contador que ejecute el método TareaHilo 
Thread hiloContador = new Thread(nuevoContador.TareaHilo); 


// Establecer el hilo como un subproceso en segundo plano para 
// que sea automáticamente abortado cuando el hilo principal 
// sea detenido 

hiloContador.IsBackground = true; 

// Iniciar el hilo contador 

hiloContador.Start(); 


blic void Setltem_lIsHilosístring item) 
// Delegado para acceder a la propiedad Items de la IsHilos 


if (IsHilos.InvokeRequired) 
( 








SetItemListDelegate delegado = 
new SetltemListDelegate(Setltem_1sHilos); 
lsHilos.Invoke(delegado, new object[] { item }); 





else 
lsHilos.Items.Add(item):; 











// Clase contador. Define un objeto "hilo contador". 
// Su método TareaHilo muestra la cuenta en la lista lIsHilos. 
public class Contador 


( 


1! 
pr 


1/ 





pu 


( 
) 
1! 


pu 
( 


pri 


Objeto Form al que pertenece la variable compartida varX 
ivate Forml m_Form; 


Identificador del hilo 
vate int m_idHilo; 








blic Contadorí(Forml formulario, int id_hilo) 





m_Form = formulario; 
m_idHilo = id_hilo; 


Contador de segundos. Se visualiza en el control IsHilos. 
blic void TareaHilo() 


string item; 
try 
( 
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// Cerrojo para que la variable compartida varX sea 
// accedida por un solo hilo cada vez. Cuando un hilo 
// echa el cerrojo (ejecuta la sección crítica), los 
// demás esperan hasta que se quite el cerrojo. 
lock (m_Form) // m_Form es el objeto en el que 
( // se va a adquirir el bloqueo 

// 1. Lectura del dato 

int i = m_Form.varkX; 


// 2. Proceso 

// Se produce un cambio de contexto 
Thread.Sleep(DateTime.Now.Millisecond % 100); 
i++; 





// 3. Escribir el resultado 

_Form.varX = 1; 

// Mostrar el valor de varX en la lista de Forml 
item = "Hilo " + m_idHilo + ": " + m_Form.varX; 
_Form.Setltem_1sHilos(item); 





) 
) 
while (true); 
) 
catch (Exception ex) 
( 
// Error inesperado 
Debug.Writeline("Error inesperado en el hilo " + m_idHilo); 
Debug.WriteLine(ex.Message); 
) 





EJERCICIOS PROPUESTOS 


1. Cuando explicamos delegados, vimos cómo utilizar el delegado MethodInvoker 
y los implementamos en nuestra aplicación ejemplo para poder acceder de forma 
segura a las propiedades de los controles del formulario. Además, observamos que 
si deteníamos la aplicación antes de que el hilo secundario terminara, el hilo pri- 
mario no finalizaba, porque, al no tener conocimiento de la finalización del se- 
cundario, seguía esperando por este hecho. También una finalización sin controlar 
de una tarea puede conducirnos a errores en los resultados. Modifique esta versión 
de la aplicación para que cuando se detenga la aplicación, los hilos finalicen de 
forma controlada. 


PARTE 











Acceso a datos 
e Enlace de datos en Windows Forms 


e Acceso a una base de datos 


e LINQ 
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ENLACE DE DATOS EN 
WINDOWS FORMS 


La finalidad de la mayoría de las aplicaciones es mostrar datos a los usuarios con 
el fin de que puedan editarlos. Esto sugiere pensar que habrá que transportar datos 
entre un origen y un destino; por ejemplo, entre el modelo de objetos obtenido del 
modelo de datos relacional de una base de datos y la interfaz gráfica de la aplica- 
ción que consume esos datos. 


ASPECTOS BÁSICOS 


El enlace de datos es un proceso que establece una conexión entre la interfaz grá- 
fica del usuario (IGU) de la aplicación y la lógica de negocio, para que cuando los 
datos cambien su valor, los elementos de la IGU que estén enlazados a ellos refle- 
jen los cambios automáticamente. 


Este proceso de transportar los datos adelante y atrás, si lo tenemos que im- 
plementar manualmente, requeriría escribir bastante código, pero utilizando los 
objetos que nos proporciona la biblioteca .NET, comprobaremos que se trata de 
un proceso sencillo. Para aclarar lo expuesto, vamos a estudiar a continuación 
ambos casos. 


Enlace de datos manual 


Consideremos una aplicación que muestre una ventana principal con una interfaz 
como la de la figura siguiente: dos cajas de texto, una para mostrar el nombre de 
una determinada persona, y la otra, para mostrar su teléfono. 
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A 


a9 Enlace de datos Ereim 





Nombre:  Abcde Fghijk 





Teléfono 123456789 





| Datos del objeto subyacente | 








| Modificar objeto subyacente | 




















Supongamos ahora que los datos que va a mostrar la ventana principal 
(Form1) proceden de un objeto de una clase CTelefono y que ambos, ventana y 


objeto, deberán permanecer sincronizados. 


Objeto 


CTelefono 





Podemos escribir la clase CTelefono, que representa los datos que muestra la 


ventana principal, como se indica a continuación: 


namespace EnlaceDatosManual 
( 
class CTelefono 
( 
private string _nombre = "Un nombre”; 
private string _telefono = "000000000"; 


public string Nombre 
( 
get { return _nombre; } 
set { _nombre = value; ) 


) 


public string Telefono 
( 
get { return _telefono; } 
set { _telefono = value; } 





Añada al proyecto una carpeta Clases y guarde esta clase dentro de esta car- 
peta (modifique el espacio de nombres para que sea EnlaceDatosManual). 
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Apoyándonos en la clase CTelefono modificamos la clase Form] como se 


muestra a continuación: 


namespace EnlaceDatosManual 


( 


public partial class Forml : Form 


( 


private CTelefono objTfno = new CTelefono(); 


public Forml() 

( 
InitializeComponent(); 
ctNombre.Text = objlfno.Nombre; 
ctTfno.Text = objlTfno.Telefono; 


1 
J 


private void btDatos0bj_Click(object sender, EventArgs e) 
{ 





string sDatos = objTfno.Nombre + "An" + objTfno.Telefono; 
MessageBox.Show(sDatos); 

1 

Í 


private void btModificar0bj_Click(object sender, EventArgs e) 


( 
) 


El código anterior crea un objeto CTelefono, denominado objTfno, iniciado 


con los valores especificados en esta clase, e inicia las cajas de texto con las pro- 
piedades Nombre y Telefono de dicho objeto. El botón “Datos del objeto subya- 
cente” permitirá mostrar los datos de este objeto. Para ello, añada el controlador 
del evento Click de btDatosObj para que invoque al método MessageBox.Show y 
muestre una ventana, como la que muestra en primer plano la figura siguiente, con 
la información requerida: 








a Enlace de datos 





Nombre: Un nombre 





Teléfono 000000000 Un nombre 


000000000 


Datos del objeto subyacente 











Modificar objeto subyacente 
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Continuando con el ejemplo, vamos ahora a hacer que el botón “Modificar 
objeto subyacente” de la interfaz de usuario permita modificar las propiedades del 
objeto (para simplificar el ejemplo, la modificación será a unos valores fijos). Pa- 
ra ello, añada el controlador del evento Click de btModificarObj y complételo 
como se indica a continuación: 


private void btModificarO0bj_Click(object sender, EventArgs e) 
( 
objTfno.Nombre = "Abcde Fghijk"; 
objTfno.Telefono = "123456789"; 
) 





Cuando se pulsa el botón “Modificar objeto subyacente” observamos que no 
se actualiza la interfaz gráfica con los nuevos valores del objeto objTfmo. Una 
forma de actualizar la interfaz gráfica del usuario sería escribir código que actua- 
lice las propiedades Text de las cajas cada vez que se modifique objTfno. 


private void btModificarO0bj_Click(object sender, EventArgs e) 
( 
objTfno.Nombre = "Abcde Fghijk"; 
objTfno.Telefono = "123456789"; 
ctNombre.Text = objTfno.Nombre; 
ctITfno.Text = objlTfno.Telefono; 





} 


Con dos líneas de código hemos solucionado el problema planteado, pero 
también observamos que cuando escribimos un nuevo valor en las cajas de texto, 
el objeto objTfno no se actualiza. Para registrar en el objeto objTfno los cambios 
que ocurren en la interfaz gráfica de usuario, se puede observar cuándo cambia la 
propiedad Text de las cajas de texto. Cuando cambia el contenido de cualquiera 
de los elementos de texto se genera, entre otros, el evento TextChanged que po- 
demos interceptar para actualizar la propiedad correspondiente del objeto de la 
clase CTelefono (asignar a Text la misma cadena dos veces consecutivas no gene- 
ra este evento dos veces, porque la segunda asignación no cambia el valor de 
Text). Según esto, añada los controladores para manejar el evento TextChanged 
de las cajas de texto y edite los métodos correspondientes así: 


private void ctNombre_TextChanged(object sender, EventArgs e) 
( 
objTfno.Nombre = ctNombre.Text'; 


} 


private void ctIfno_TextChanged(object sender, EventArgs e) 
{ 





objTfno.Telefono = ctTfno.Text; 
) 
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Evidentemente, el ejemplo es muy sencillo y hemos requerido escribir muy 
poco código para sincronizar la interfaz gráfica del usuario con un origen de datos 
CTelefono, pero no resultará así de sencillo cuando la aplicación sea bastante más 
compleja, por lo que esperamos que .NET nos proporcione algo mejor. 


Notificar cuándo cambia una propiedad 


Una forma más profesional y más robusta de que la interfaz gráfica registre los 
cambios del objeto con el que está vinculada es que el objeto genere un evento 
cuando cambie alguna de sus propiedades para que la interfaz gráfica lo pueda in- 
terceptar y responder actualizándose. Una forma sencilla de hacer esto es que la 
clase del objeto implemente la interfaz INotifyPropertyChanged del espacio de 
nombres System.ComponentModel. 


La interfaz INotifyPropertyChanged se utiliza para notificar a los clientes, 
generalmente enlazados, que una propiedad ha cambiado. Esta interfaz proporcio- 
na el evento PropertyChanged que habrá que generar cuando el valor de una 
propiedad cambie. 


Por ejemplo, consideremos la clase CTelefono con sus propiedades Nombre y 
Telefono. Si esta clase implementa la interfaz INotifyPropertyChanged, un obje- 
to de la misma podrá notificar que cambió una de sus propiedades generando el 
evento PropertyChanged según se indica a continuación: 


using System.ComponentModel'; 


namespace EnlaceDatosManual 
( 
class CTelefono : INotifyPropertyChanged 
( 
private string _nombre = "Un nombre”; 
private string _telefono = "000000000"; 


public event PropertyChangedEventHandler PropertyChanged; 


private void NotificarCambio(string nombreProp) 
( 





if (this.PropertyChanged != null) 
PropertyChanged(this, 
new PropertyChangedEventArgs(nombreProp)); 
} 


public string Nombre 

{ 
get { return _nombre; } 
set 
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( 
_nombre = value; 
NotificarCambio("Nombre"); 
) 
) 


public string Telefono 
( 
get { return _telefono; } 
set 
( 
_telefono = value; 
NotificarCambio("Telefono"); 
) 


El código anterior muestra que un objeto CTelefono generará un evento Pro- 
pertyChanged cada vez que cambie el valor de alguna de sus propiedades. Ob- 
serve que cuando se asigna un nuevo valor a la propiedad se invoca al método 
NotificarCambio que generará dicho evento. También podemos observar que el 
método que responderá a este evento tiene dos parámetros: el primero es una refe- 
rencia al objeto CTelefono que genera el evento, y el segundo, los datos de tipo 
PropertyChangedEventArgs relacionados con el evento, que en este caso se co- 
rresponden con el nombre de la propiedad que ha cambiado. 


Ahora, podemos utilizar este evento para mantener la interfaz del usuario sin- 
cronizada con el objeto CTelefono, operación que antes realizábamos manualmen- 
te en el método btModificarObj_Click y que ahora, al no realizarla, quedará así: 


private void btModificarO0bj_Click(object sender, EventArgs e) 
( 
objTfno.Nombre = "Abcde Fghijk"; 
objTfno.Telefono = "123456789"; 





} 


La modificación que realiza el método anterior sobre cada una de las propie- 
dades Nombre y Telefono generará para cada una de ellas el evento Pro- 
pertyChanged que la ventana principal, clase Form1, interceptará para actualizar 
la caja de texto correspondiente. Según esto, añada el controlador para este evento 
y complete el código como se indica a continuación: 


using System.ComponentModel; 


namespace EnlaceDatosManual 


( 
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public partial class Forml : Form 
( 


private CTelefono objlfno = new Clelefono(); 


public Forml() 
( 
InitializeComponent(); 
ctNombre.Text = objTfno.Nombre; 
ctTfno.Text = objlTfno.Telefono; 
objTfno.PropertyChanged += objlfno_PropertyChanged; 





) 


private void objTfno_PropertyChanged(object sender, 
PropertyChangedEventArgs e) 
{ 





switch (e.PropertyName) 
{ 
case "Nombre": 
ctNombre.Text = objTfno.Nombre; 
break; 
case "Telefono": 
ectTfno.Text = objlIfno.Telefono; 
break; 


de 


Observe en el código anterior que el método que responderá al evento Pro- 
pertyChanged es objTfno_PropertyChanged y que este, en función de la propie- 
dad del objeto CTelefono que haya cambiado, actualiza la caja de texto 
correspondiente con ese nuevo valor. 


Ahora, con independencia de dónde cambien los datos, tanto el objeto CTele- 
fono como la interfaz gráfica permanecen sincronizados. Resumiendo, conseguir 
esta sincronización ha supuesto: 


e Establecer los valores iniciales de las cajas de texto y definir el controlador 
para el evento PropertyChanged en el constructor Form]. 


e Escribir el método objTfno_PropertyChanged que responderá al evento Pro- 
pertyChanged para actualizar las cajas de texto con los nuevos valores del 
objeto CTelefono. 


e Añadir a la clase Form1 el controlador del evento TextChanged para cada 
una de las cajas de texto. 
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e Escribir los métodos ctNombre_TextChanged y ctTelefono_TextChanged que 
responderán al evento TextChanged para actualizar el objeto CTelefono con 
los nuevos valores de las cajas de texto. 


Según lo expuesto, cabe pensar que a medida que aumente el número de pro- 
piedades del objeto o el número de objetos que estemos manejando, el código que 
tendríamos que escribir sería mayor. Para minimizar este problema, .NET propor- 
ciona un modelo de enlace de datos. 


Enlace de datos con las clases de .NET 


Según lo expuesto hasta ahora, podemos decir que el enlace de datos es un meca- 
nismo que establece una conexión entre la interfaz gráfica del usuario de una apli- 
cación (en nuestro ejemplo, la definida por la ventana Forml) y los datos 
proporcionados por objetos pertenecientes a la lógica de negocio de dicha aplica- 
ción (en nuestro ejemplo, por el objeto CTelefono). Dicho mecanismo permite que 
los elementos que están enlazados a los objetos de datos reflejen los cambios au- 
tomáticamente cuando los datos cambian su valor, y viceversa, que los objetos re- 
flejen los cambios automáticamente cuando los elementos de la interfaz cambian 
su valor. Según lo expuesto, la base de este mecanismo es vincular/enlazar pares 
de propiedades y proveer un mecanismo de notificación de cambios; en el ejem- 
plo que acabamos de desarrollar, cada par está compuesto por una propiedad del 
objeto CTelefono y la propiedad Text de la caja de texto correspondiente; y el 
mecanismo de notificación de cambios lo proporciona la interfaz INotifyPro- 
pertyChanged. .NET sigue el mismo mecanismo pero dejando todo el proceso de 
sincronización y conversión de los datos para el objeto de enlace, según muestra 
la figura siguiente. El objeto de enlace es proporcionado por la clase Binding. 


Objeto de 
enlace 





Propiedad Sincronización y Propiedad 
Í conversión | 


En .NET, normalmente, cada enlace tiene, al menos, estos componentes: 


Un objeto destino del enlace (el elemento). 

Una propiedad de destino (una propiedad del elemento). 

Un objeto origen del enlace (el objeto). 

Y una ruta de acceso al valor que se va a usar del objeto origen del enlace (la 
propiedad del objeto). 
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Por ejemplo, en la aplicación anterior el objeto destino del enlace es una caja 
de texto, la propiedad de destino es su propiedad Text, el objeto origen del enlace 
es el objeto CTelefono y el valor que se usa del objeto origen del enlace es su pro- 
piedad Nombre o Telefono. 


El ejemplo expuesto no nos debe hacer pensar que el objeto asociado con el 
objeto origen del enlace esté restringido a ser un objeto CLR personalizado. Por 
ejemplo, el objeto origen del enlace puede ser también: 


e Un objeto de cualquier clase que implemente IBindingList o ITypedList, 
como sucede con DataSet, DataTable, DataView o DataViewManager. 
Cuando el origen de datos es DataSet, DataTable o DataViewManager, en 
realidad se está creando un enlace a DataView. En consecuencia, las filas en- 
lazadas son realmente objetos DataRowView (veremos esto con más detalle 
en el capítulo Acceso a una base de datos). 


e Una colección que implemente IList como, por ejemplo, ArrayList. Es nece- 
sario crear y llenar la colección antes de crear el enlace. Todos los objetos de 
la lista deben ser del mismo tipo; de lo contrario, se produce una excepción. 


La clase Binding 


Un enlace de datos en .NET viene definido por un objeto de la clase Binding. Es- 
te objeto conecta, de forma transparente para el desarrollador, las propiedades de 
dos objetos diferentes: uno se corresponde con el destino del enlace (normalmen- 
te, controles de Windows Forms) y el otro, con el origen del enlace (objeto de da- 
tos; por ejemplo, una base de datos o cualquier objeto que contenga datos), con el 
fin de sincronizar los valores de sus propiedades. Para gestionar el enlace entre 
esas propiedades la clase Binding proporciona cierta funcionalidad, de la cual 
destacamos las propiedades siguientes: 


e DataSource obtiene el origen de datos para este enlace. 


e ControlUpdateMode indica cuándo se propagan los cambios realizados en el 
origen de datos a la propiedad del control enlazado. El valor predeterminado 
es OnPropertyChanged, que especifica que el control enlazado se actualiza 
cuando cambia el valor del origen de datos o cuando cambia la posición en el 
mismo. El otro valor es Never, que especifica que el control enlazado nunca 
se actualiza cuando cambia un valor del origen de datos. 


e DataSourceUpdateMode indica cuándo se propagan los cambios realizados 
en la propiedad del control enlazado al origen de datos. El valor predetermi- 
nado es OnValidation, que especifica que el origen de datos se actualiza 
cuando se valida la propiedad del control. Los otros valores son OnPro- 
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pertyChanged, el origen de datos se actualiza cada vez que cambia el valor 
de propiedad del control, y Never, el origen de datos nunca se actualiza. 


e  PropertyName indica el nombre de la propiedad enlazada del control. 


e  FormattingEnabled almacena un valor booleano que indica si se aplica for- 
mato y conversión de tipos a los datos de la propiedad del control. 


Y los eventos siguientes: 


e BindingComplete, que se genera cuando la propiedad FormattingEnabled 
está establecida en true y se ha completado una operación de enlace. 


e Format, que se genera cuando se insertan datos en el control desde el origen 
de datos, por lo que se puede controlar este evento para convertir los datos sin 
formato del origen de datos en los datos con formato que se van a mostrar. 


e Parse, que se genera cuando cambia el valor de un control con enlace a datos, 
por lo que se puede controlar este evento para quitar el formato del valor mos- 
trado antes de almacenarlo en el origen de datos. 


El siguiente ejemplo sincroniza, en las dos direcciones, las propiedades Nom- 
bre del objeto objTfno y Text de la caja de texto ctNombre: 


ctNombre.DataBindings.Add(new Binding("Text", objTfno, "Nombre")); 


Observamos que los controles que pueden tener un enlace tienen una propie- 
dad DataBindings que hace referencia a una colección ControlBindingsCollec- 
tion de objetos Binding. Para agregar un Binding a la colección, se llama al 
método Add de la colección, con lo que se enlaza una propiedad del control a una 
propiedad de un objeto (o a una propiedad del objeto actual de una lista). 


Hemos dicho que los enlaces permiten actualizar el destino o el origen del en- 
lace, pero ¿cuándo ocurre la actualización? Esto está definido por las propiedades 
ControlUpdateMode y DataSourceUpdateMode del enlace (objeto Binding), 
según hemos explicado anteriormente. 


Tipos de enlace 


El enlace puede ser sencillo o complejo. Decimos que el enlace es sencillo cuando 
un control se enlaza a un único elemento de datos. Por ejemplo, cualquier propie- 
dad de un control se puede enlazar a un campo de una base de datos. Es el tipo de 
enlace típico para controles que suelen mostrar un único valor, como ocurre con 
TextBox. Y decimos que el enlace es complejo cuando un control puede enlazarse 
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a más de un elemento de datos, normalmente a más de un registro de una base de 
datos. El enlace complejo también se denomina “enlace basado en lista”. Ejem- 
plos de controles que admiten el enlace complejo son DataGridView, ListBox y 
ComboBox. 


Componente BindingSource 


Para simplificar el enlace de datos, los formularios Windows Forms permiten en- 
lazar un origen de datos al componente BindingSource y, a continuación, enlazar 
controles a BindingSource, esto es, este componente actúa como un intermedia- 
rio entre el origen de datos y los controles enlazados. 


Notificación de cambios en un enlace de Windows Forms 


Para garantizar la actualización del origen de datos y de los controles enlazados, 
hay que notificar a los controles enlazados los cambios realizados en su origen de 
datos, y al origen de datos, los cambios realizados en las propiedades enlazadas de 
los controles. Estas notificaciones se realizarán a través del enlace. 


Si el enlace es sencillo, el objeto debe proporcionar la notificación de cambios 
cuando cambia el valor de la propiedad enlazada, por ejemplo, implementando la 
interfaz INotifyPropertyChanged, según explicamos anteriormente. 


Si se utilizan objetos que implementan la interfaz INotifyPropertyChanged, 
no es preciso utilizar BindingSource para enlazar el objeto a un control, aunque 
es recomendable utilizarlo por la facilidad que ofrece. 


Ahora, si el enlace es a una lista de objetos, el control deberá ser informado 
sobre el cambio de las propiedades de los elementos de la lista cuando esté enla- 
zado a una de estas propiedades, o sobre los cambios de la lista (se elimina o se 
agrega un elemento a la lista) cuando esté enlazado a la lista. En este caso, la lista 
debe implementar la interfaz IBindingList, que proporciona ambos tipos de noti- 
ficación de cambios. Precisamente, BindingList<7> es una implementación ge- 
nérica de IBindingList y se ha diseñado para el enlace de datos de formularios 
Windows Forms. Si la lista enlazada no implementa la interfaz IBindingList, en- 
tonces tendremos que enlazarla al componente BindingSource. 


Crear un enlace 


Para aplicar los conocimientos expuestos hasta ahora, vamos a reproducir la apli- 
cación EnlaceDatosManual que realizamos anteriormente. Para ello, cree una 
nueva aplicación denominada EnlaceDatosNET, diseñe la misma interfaz mostra- 
da por EnlaceDatosManual y añada al proyecto la misma clase CTelefono con no- 
tificación de cambios que incluía esa aplicación, ya que estas notificaciones son 
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utilizadas por el objeto de enlace para mantener la interfaz gráfica sincronizada 
con el objeto origen del enlace. 












a Enlace de datos = 





Nombre: = Abcde Fghijk 





Teléfono 123456789 Abcde Fghijk 


123456789 





Datos del objeto subyad| 



























Definimos en la clase Form]l el objeto objTfno de la clase CTelefono y crea- 
mos los enlaces de las cajas de texto con las propiedades correspondientes del ob- 
jeto obj Tfno: 


public partial class Forml : Form 
( 
private CTelefono objTfno = new CTelefono(); 


public Forml() 
( 
InitializeComponent(); 
ctNombre.DataBindings.Add( 
new Binding("Text", objTfno, "Nombre")); 
ctIfno.DataBindings.Add( 
new Binding("1 





ext”, obio, “"relerfono")): 
) 





private void btDatos0bj_Click(object sender, EventArgs e) 

( 
string sDatos = objlfno.Nombre + "An" + objTfno.Telefono; 
MessageBox.Show(sDatos):; 

) 


private void btModificar0bj_Click(object sender, EventArgs e) 
( 
objTfno.Nombre = "Abede Fahijk"; 
objTfno.Telefono = "123456789"; 
) 





} 


Una vez ejecutados los pasos anteriores, si ejecuta la aplicación observará que 
la interfaz gráfica y el objeto CTelefono ya están sincronizados. 
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También podríamos haber realizado el enlace utilizando un objeto Binding- 
Source como se indica a continuación. Este componente simplifica los enlaces a 
datos proporcionando la notificación de cambios, la administración de enlaces, así 
como otros servicios. Su propiedad DataSource será la que haga referencia al 
origen de datos y para enlaces complejos, opcionalmente, se puede establecer su 
propiedad DataMember. A continuación los controles serán enlazados a Bin- 
dingSource y la interacción con los datos se logrará utilizando la funcionalidad 
aportada por este componente. 


BindingSource bs = new BindingSource():; 

bs.DataSource = objlfno; 

ctNombre.DataBindingas.Add(new Binding("Text", bs, "Nombre")); 
ctTfno.DataBindings.Add(new Binding("Text", bs, "Telefono")); 


Obsérvese que ahora el origen de datos para los enlaces es el objeto Binding- 
Source. 


Enlaces con otros controles 


También es posible enlazar la propiedad de un elemento con la propiedad de 
otro elemento. Por ejemplo, sincronizar el color del texto de la caja de texto 
ctTfno con el color del texto de c£Nombre; de esta forma, cuando cambiemos el 
color del texto de la caja c£Nombre también cambiará al mismo color el texto de la 
caja ctTfno. 


ctTfno.DataBindings.Add( 
new Binding("ForeColor", ctNombre, "ForeColor")); 


El código anterior enlaza la propiedad ForeColor de ctTfno con la propiedad 
ForeColor del control c£Nombre. 


Aplicar conversiones 


Se pueden aplicar conversiones antes de mostrar los datos en el destino o an- 
tes de almacenarlos en el origen controlando los eventos Format y Parse. El pri- 
mero se invoca cuando los datos fluyen en la dirección origen-destino (porque hay 
que actualizar el destino debido a que el origen ha cambiado), y el segundo, cuan- 
do los datos fluyen en la dirección contraria (porque hay que actualizar el origen 
debido a que el destino ha cambiado). La figura siguiente aclara lo expuesto: 
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Destino del enlace Objeto de enlace Origen del enlace 


Controladores de 


Propiedad mi E Propiedad 
¡UC y 


Por ejemplo, vamos a modificar la aplicación EnlaceDatosNET para que aho- 
ra muestre el dato teléfono con un determinado formato y lo guarde con otro dife- 
rente. Para ello, lo primero que vamos a hacer es cambiar el atributo _ telefono y la 
propiedad Telefono de tipo string a decimal. Esto requerirá cambiar también los 
valores que asignábamos a esta propiedad en la aplicación. Por ejemplo: 





objlTfno.Telefono = 123456789M; 


A continuación, vamos a hacer que el número de teléfono que está almacena- 
do en decimal en la propiedad Telefono del objeto objTfno se muestre en la caja 
de texto ctTfno con el formato “000 000 000” (realizar la conversión de decimal a 
string insertando un espacio cada tres dígitos) y se almacene, cuando se modifi- 
que el valor mostrado, como un valor decimal (realizar la conversión de string a 
decimal). Estas dos operaciones requieren controlar los eventos Format y Parse, 
por lo tanto, añadimos los controladores de estos eventos de tipo ConvertEvent- 
Handler al objeto Binding vinculado con la caja de texto ctTfno: 


public Forml() 
( 


=- 


nitializeComponent(); 
ctNombre.DataBindings.Add( 
new Binding("Text 
ctTfno.DataBindings.Add( 
new Binding("Text", objlTfno, elefono")); 

/ Controlar los eventos Parse y Format del enlace de ctlIfno 
inding blelefono = ctIfno.DataBindings["Text"]; 
Telefono.Parse += new ConvertEventHandler(StringloDecimal); 
Telefono.Format += new ConvertEventHandler(DecimalToString); 


objTfno, "Nombre")); 




















INS 


Cuando se genera el evento Parse se ejecuta el método StringToDecimal que 
mostramos a continuación. Este evento se genera siempre que el valor mostrado 
por la caja de texto ctTfno cambie, porque esto implica que la propiedad Telefono 
del objeto CTelefono origen del enlace tiene que actualizarse. 


private void StringloDecimal(object sender, ConvertEventArgs e) 
( 
// Parse ocurre siempre que haya que actualizar 
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// la propiedad Telefono con el contenido de ctTfno 
if (e.Desiredlype != typeofí(decimal)) return; 
try 
( 
e.Value = Decimal.Parse(e.Value.ToString()); 
) 
catch (FormatException exc) 
( 
MessageBox.Show("Introducir el teléfono sin espacios”); 
) 





} 


La clase ConvertEventArgs permite aplicar o quitar el formato de valores 
mostrados por un control Windows Forms enlazado a un origen de datos a través 
de un objeto Binding, y su propiedad DesiredType permite comprobar el tipo de 
la propiedad al que se va a convertir el valor (decimal en este caso). En nuestro 
caso observamos que el valor proporcionado por la propiedad Value de Convert- 
EventArgs es el valor string con formato que se convierte a un valor decimal sin 
formato. En el evento Parse, se obtiene el valor con formato, se analiza si proce- 
de, y se vuelve a convertir en el mismo tipo de datos del origen de datos. A conti- 
nuación, se puede restablecer la propiedad Value con el valor sin formato, con lo 
que se establece el valor del origen de datos. 


Cuando se genera el evento Format se ejecuta el método DecimalToString 
que mostramos a continuación. Este evento se genera siempre que la caja de texto 
ctTfno muestre un nuevo valor debido a que la propiedad Telefono del objeto 
CTelefono ha cambiado. 


private void DecimalToString(object sender, ConvertEventArgs e) 
( 

// Format ocurre siempre que haya que mostrar en ctTfno 

// el valor de la propiedad Telefono 

1f (e.Desiredlype != typeof(string)) return; 

e.Value = ((decimal)e.Value).ToString("3 000 000 000"); 
) 


La propiedad DesiredType de ConvertEventArgs permite comprobar el tipo 
de la propiedad al que se va a convertir el valor (string en este caso). En nuestro 
caso observamos que el valor sin formato proporcionado por la propiedad Value 
de ConvertEventArgs es el valor decimal que se convierte a un valor string con 
formato. En el evento Format, se obtiene el valor sin formato de la propiedad Va- 
lue de ConvertEventArgs, se le aplica formato y se restablece esta propiedad con 
ese nuevo valor, que será mostrado en el control enlazado. 


Otra verificación que podemos hacer es que el nombre no sea una cadena va- 
cía, que solo pueda contener letras y espacios en blanco, y que empiece por una 
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letra. Esta operación requiere controlar el evento Parse del enlace correspondiente 
a la caja de texto c£Nombre, por lo tanto, añadimos el controlador de este evento 
al objeto Binding vinculado con la caja de texto ctNombre: 


Binding bNombre = ctNombre.DataBindings["Text"]; 
bNombre.Parse += new ConvertEventHandler(bNombre_Parse); 


Cuando se genera el evento Parse se ejecuta el método bNombre_Parse que 
mostramos a continuación. Este evento se genera siempre que el valor mostrado 
por la caja de texto c(Nombre cambie, porque esto implica que la propiedad Nom- 
bre del objeto CTelefono origen del enlace tiene que actualizarse. 


private void bNombre_Parse(object sender, ConvertEventArgs e) 
( 
// Parse ocurre siempre que haya que actualizar 
// Ta propiedad Nombre con el contenido de ctNombre 
1f (e.Desiredlype != typeof(string)) return; 
try 
( 
// Expresión regular: una o más letras y espacios 
Regex ex_reg = new Regex(""([a-zA-ZANAGA6E1 TÓ0UUTAAS*)+$"); 
if (lex_reg.IsMatch(e.Value.ToString())) 
throw new FormatException("Debe especificar un nombre"); 
) 
catch (FormatException exc) 
( 
MessageBox.Show(exc.Message); 
) 
) 


La clase Regex del espacio de nombres System.Text.RegularExpressions 
representa una expresión regular y su método IsMatch devuelve true si la cadena 
pasada como argumento se ajusta al patrón indicado por la expresión regular es- 
pecificada en el constructor Regex. Las expresiones regulares proporcionan un 
método eficaz y flexible para validar un texto con el fin de asegurar que se corres- 
ponde con un modelo predefinido. En nuestro caso, la expresión regular especifi- 
cada cumple con los requisitos pedidos. Para más detalles, véase el apartado 
Expresiones regulares del capítulo Introducción a Windows Forms. 


Otra forma de realizar esta misma validación es controlando el evento Bin- 
dingComplete de Binding, que se produce independientemente del estado de fi- 
nalización de la operación de enlace, estado que se puede determinar examinando 
la propiedad BindingCompleteState del parámetro de tipo BindingComple- 
teEventArgs asociado al evento. Otros componentes, como BindingSource y 
CurrencyManager también pueden producir este evento. En el caso de un com- 
ponente Binding, solo se produce si la propiedad de FormattingEnabled vale 
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true y se completa una operación de enlace, como ocurre cuando se insertan los 
datos del control en el origen de datos o viceversa. Esto es, la propiedad corres- 
pondiente se ve modificada con los cambios realizados, cosa que no ocurría cuan- 
do anteriormente interceptamos el evento Parse. 


La propiedad FormattingEnabled del objeto Binding se puede establecer a 
true durante la construcción de este objeto, especificando este valor como cuarto 
parámetro del constructor Binding: 


ctNombre.DataBindings.Add(new Binding("Text", objlTfno, "Nombre", true)); 


Según lo expuesto, añadimos el controlador del evento BindingComplete al 
objeto Binding vinculado con la caja de texto ctNombre: 


Binding bNombre = ctNombre.DataBindings["Text"]; 
bNombre.BindingComplete += 
new BindingCompleteEventHandler(bNombre_BindingComplete); 


Ahora, cuando se genere el evento BindingComplete se ejecutará el método 
bNombre_BindingComplete que mostramos a continuación. Este evento se genera 
siempre que se completa la transferencia de datos a través del enlace. 


public void bNombre_BindingComplete(object sender, 
BindinglompleteEventArgs e) 
( 
if (e.BindingCompleteState != BindingCompleteState.Success) 
MessageBox.Show(e.ErrorText); 


La propiedad BindingCompleteState del objeto BindingCompleteEvent- 
Args indica el resultado de la operación de enlace, que puede ser Success si se 
completó correctamente, DataError si se produjo un error de datos y Exception si 
se lanza una excepción. Este último estado es el que vamos a utilizar en nuestra 
aplicación: lanzar una excepción, por ejemplo de tipo FormatException, cuando 
al finalizar la operación de enlace los datos no tienen el formato esperado. Para 
ello, modificaremos la propiedad Nombre de CTelefono así: 


public string Nombre 
( 
get [ return _nombre; } 
set 
( 
_nombre = value; 
// Expresión regular: una o más letras y espacios 
Regex ex_reg = new Regex("^([a-zA-ZňÑŇÑáÁéÉíÍÓĆÓQÚJ\\s*)+$"); 
ir (lex_reg.IsMatchívalue.ToString())) 
throw new FormatException("Debe especificar un nombre"); 
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NotificarCambio("Nombre"):; 
) 
) 


La propiedad ErrorText de BindingCompleteEventArgs devuelve la des- 
cripción del error ocurrido cuando se lanzó una excepción durante la operación de 
enlace; en nuestro caso devuelve “Debe especificar un nombre”. 


ORÍGENES DE DATOS COMPATIBLES CON WINDOWS FORMS 


Hasta ahora nos hemos limitado a realizar enlaces sencillos (con objetos senci- 
llos). Pero con Windows Forms también se pueden realizar enlaces complejos se- 
gún expusimos anteriormente en el apartado Enlace de datos con las clases de 
«NET. Allí vimos que para los enlaces sencillos Windows Forms admite el enlace 
a las propiedades públicas del objeto sencillo y que para los enlaces complejos, el 
objeto debe ser compatible con alguna de las interfaces IList, IBindingList, 
IBindingListView, IEditableObject, ICancelAddNew, IDataErrorInfo, ITy- 
pedList, IListSource o INotifyPropertyChanged, entre otras, o con la interfaz 
TEnumerable si el enlace se realiza a través de un componente BindingSource. 


Por ejemplo, las clases Array, ArrayList o CollectionBase implementan la 
interfaz IList; los objetos de estas clases son listas que deben contener tipos ho- 
mogéneos. La clase BindingList permite crear una colección que ofrece posibili- 
dades de ordenación básicas y notificación de cambios, tanto cuando cambian los 
elementos de la colección como cuando cambia la colección en sí. Y un objeto 
que implementa la interfaz INotifyPropertyChanged genera un evento cuando el 
valor de cualquiera de sus propiedades cambia. 


De forma resumida, a continuación se indican las estructuras con las que se 
puede realizar un enlace en Windows Forms: 


e Objetos sencillos. Windows Forms admite enlazar propiedades de un control 
con propiedades públicas de un objeto utilizando la clase Binding. 


e Matriz o colección. Una matriz o una colección que actúe como origen de da- 
tos debe implementar la interfaz IList; un ejemplo sería una matriz de la clase 
ArrayList. En general, es recomendable utilizar colecciones BindingList<7> 
para construir listas de objetos que se vayan a utilizar como orígenes de datos. 
BindingList<7> es una versión genérica de la interfaz IBindingList, la cual 
amplía la interfaz IList agregando propiedades, métodos y eventos necesarios 
para el enlace de datos bidireccional. 
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e  BindingSource. Es el origen de datos más común en Windows Forms. Los 
controles se enlazan a BindingSource y este se enlaza al origen de datos (por 
ejemplo, una tabla de datos ADO.NET o un objeto comercial). También per- 
mite enlazar orígenes de datos que implementan la interfaz IEnumerable con 
controles como DataGridView y ComboBox que no admiten directamente el 
enlace a orígenes de datos IEnumerable. En este caso, BindingSource com- 
patibilizará el origen de datos con la interfaz IList. 


e lEnumerable. Los enlaces de controles Windows Forms a orígenes de datos 
que solo admiten la interfaz IEnumerable se tienen que realizar a través de 
un componente BindingSource. 


e Objetos de datos de ADO.NET. ADO.NET proporciona varias estructuras de 
datos adecuadas para el enlace: DataColumn, DataTable, DataView, Data- 
Set y DataViewManager. Estos objetos, así como los enlaces con los mis- 
mos, serán estudiados en el capítulo Acceso a una base de datos. 


Según lo expuesto, los enlaces de datos en Windows Forms permiten acceder 
a datos almacenados tanto en bases de datos como en otras estructuras de datos, 
como las matrices y las colecciones. Ahora bien, ¿cómo se administran esos enla- 
ces? La figura siguiente expone de forma clara la respuesta a esta pregunta: 






Formulario 
Windows 


CurrencyManager CurrencyManager 


Cada formulario Windows tiene al menos un objeto BindingContext (una co- 
lección) que administra todos los objetos BindingManagerBase de dicho formu- 
lario. Por cada origen de datos hay un objeto CurrencyManager o 
PropertyManager, clases derivadas de la clase BindingManagerBase. 


CurrencyManager 
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Para obtener el objeto BindingManagerBase asociado con un origen de datos 
hay que usar BindingContext de una de las dos formas siguientes: BindingCon- 
text[origen de datos] para obtener el objeto BindingManagerBase asociado al 
origen de datos especificado o bien BindingContext/[origen de datos, miem- 
bro_de datos] para obtener un objeto BindingManagerBase asociado al origen 
de datos y miembro de datos especificados. 


El objeto real que se devuelve, CurrencyManager o PropertyManager, de- 
pende del origen de datos. Si el origen de datos solo puede devolver una única 
propiedad (por ejemplo un objeto CTelefono enlazado con un TextBox), se de- 
volverá un PropertyManager, en cambio, si el origen de datos implementa la in- 
terfaz IList o IBindingList, entre otras, se devolverá CurrencyManager. 


Por ejemplo, suponiendo que hemos enlazado una colección de objetos CTe- 
lefono a un control ListBox de un formulario referenciado por this, el código si- 
guiente accede al elemento actualmente seleccionado de dicha colección: 


CurrencyManager cm = this.BindingContext[colTfnos] as CurrencyManager; 
MessageBox.Show((cm.Current as Clelefono).Nombre); 


La propiedad Current devuelve el elemento actual en la lista subyacente (en 
el ejemplo, colección colTfnos). Para cambiar a otro elemento modificaremos el 
valor de la propiedad Position que debe ser mayor que 0 y menor que el valor de 
la propiedad Count. 


El objeto CurrencyManager tiene como misión mantener sincronizados los 
controles enlazados a datos entre ellos (por ejemplo, para que todos muestren da- 
tos del mismo registro). Y, ¿cómo lo hace? Pues administrando la colección Bin- 
dings de enlaces Binding asociada con un origen de datos. 


Enlace a colecciones de objetos 


El origen de un enlace puede ser un objeto único, cuyas propiedades contienen los 
datos, o una colección de objetos resultado, por ejemplo, de una consulta a una 
base de datos. Para mostrar una colección de objetos es bastante habitual utilizar 
un Control, como por ejemplo ListBox, ComboBox y DataGridView. 


Para enlazar un Control a una colección de objetos, la propiedad que se utili- 
za es DataSource. Esto es, se puede considerar la propiedad DataSource como el 
contenido del Control. 
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List 


La clase List<7> es el equivalente genérico de la clase ArrayList, pero su rendi- 
miento es mejor que el de ArrayList y, además, tiene seguridad de tipos. La clase 
List<7> implementa la interfaz genérica IList<7> y permite construir matrices 
cuyo tamaño varía dinámicamente según los requerimientos. 


Como ejemplo, vamos a diseñar una aplicación que muestre una ventana que 
presente un objeto ListBox enlazado a una lista de objetos CTelefono almacena- 
dos en una colección de tipo List. La lista presentará los nombres de las personas 
y una caja de texto de solo lectura mostrará el teléfono correspondiente al elemen- 
to seleccionado de la lista. Otras dos cajas de texto permitirán introducir los datos 
para añadir un nuevo elemento (botón Añadir), o modificar el elemento actual- 
mente seleccionado (botón Modificar), y otro botón, Borrar, permitirá eliminar el 
elemento actualmente seleccionado de la lista. 
































m 
a Form1 l calel čsl 
Persona 1 o Zi Persona 4 M 
Persona 2 
Persona 3 3 
F 
Persona 5 l Añadir ] 
Persona 6 
Persona 7 x 1 
> d | Borar j 
636344968 | Modificar | 




















Para ello, cree una nueva aplicación denominada List y diseñe la interfaz mos- 
trada por la figura anterior. Los controles, con sus propiedades, que ahí aparecen 
se especifican en la tabla siguiente: 


Caja de texto (Name) ctTfnoSelec 
ReadOnly True 


(Name) 
( 
e 
e 


Text Añadir 

Text Borrar 
(Name) btModificar 

Text Modificar 
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A continuación añada al proyecto, en una carpeta Clases, la clase CTelefono 
especificada a continuación: 


namespace List 
{ 
class CTelefono 
( 
private string _nombre = "Un nombre”; 
private decimal _telefono = 0; 


public string Nombre 

( 
get { return _nombre; } 
set [ _nombre = value; ) 


) 


public decimal Telefono 
( 
get { return _telefono; } 
set [ _telefono = value; ) 





Después, añada una nueva clase FactoriaCTelefono que nos permita construir 
una lista de objetos CTelefono con unos valores cualesquiera. 


using System.Collections.Generic; 


namespace List 
( 
class FactoriaCTelefono 
( 
private static List<CTelefono» _telefonos; 


// Nuevo CTelefono 
public static Clelefono CrearCTelefono(string nom, decimal tfn) 
( 
CTelefono tfno = new CTelefono(); 
tfno.Nombre = nom; 
tfno.Telefono = tfn; 
return tfno; 
) 


public static List<CTelefono> ObtenerColeccionCTelefono() 
( 


_telefonos 


new List<CTelefono»(); 


Random rnd = new Random():; 
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for (int i = 1; i < 10; i++) 
{ 
_telefonos.Add(CrearCTelefono("Persona "+i, 
rnd.Next(636000000, 636999999))); 

) 

return _telefonos; 

) 
) 
) 


Observe que la clase FactoriaCTelefono define un método ObtenerColec- 
cionCTelefono que devuelve la colección de objetos CTelefono generada. En una 
aplicación real, los datos de estos objetos podrían obtenerse de una base de datos. 


El paso siguiente es enlazar los controles listTfnos, de tipo ListBox, y ctTfno- 
Selec, de tipo TextBox, con el origen de datos, esto es, con la colección de objetos 
CTelefono que construiremos cuando se cargue el formulario. Para ello, defina en 
la clase Form/1 el atributo privado colTfnos que hará referencia a dicho origen de 
datos. Después, añada el controlador del evento Load del formulario y edítelo 
como se indica a continuación: 


public partial class Forml : Form 
( 
private list<Cleltefono>» colliinos:; 


public Forml1() 

( 

nitializeComponent(); 
) 


private void Forml_Load(object sender, EventArgs e) 
( 
colTfnos = FactoriaCTelefono.ObtenerColeccionCTelefono(); 
listTfnos.DataSource = colTfnos; 

listIfnos.DisplayMember = "Nombre"; 
ctTfnoSelec.DataBindings.Add("Text", colTfnos, "Telefono"); 











Observe que el método Forml1_Load construye la colección origen de los da- 
tos y la asigna a la propiedad DataSource del control ListBox; después, a través 
de la propiedad DisplayMember de este control indica el dato que debe mostrar: 
la propiedad Nombre de los objetos CTelefono de la colección. Finalmente, esta- 
blece un enlace entre la propiedad Text de la caja de texto ctTfnoSelec y la pro- 
piedad Telefono de los objetos CTelefono de la colección. 
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Si ejecuta ahora la aplicación, observará que el control /istTfnos muestra la 
lista de los nombres correspondientes a los objetos de la colección y que la caja de 
texto ctTfmoSelec muestra el teléfono correspondiente al elemento seleccionado de 
la lista. 


Como siguiente paso vamos a escribir el código del controlador del evento 
Click del botón Añadir para que permita al usuario añadir un nuevo objeto CTele- 
fono a la colección. Añada, entonces, este controlador y edítelo como se indica a 
continuación: 


private void btAñadir_Click(object sender, EventArgs e) 
( 
decimal tef = 0; 
if (ctNombre.Text.length != 0 84 ctIfno.Text.Length != 0 84 
Decimal.TryParse(ctIfno.Text, out tef)) 
colTfnos.Add(FactoriaCTelefono.CrearCTelefono(ctNombre.Text, tef)); 


Este método, primero verifica que los datos introducidos por el usuario en las 
cajas de texto ctNombre y ctTfno son válidos, y después invoca al método Crear- 
CTelefono de FactoriaCTelefono para crear el nuevo objeto CTelefono que se 
añade a la colección colTfnos. 


Si ahora ejecuta la aplicación, observará que el control ListBox no visualiza 
el nuevo elemento, pero sí puede comprobar, ejecutando la aplicación en modo 
depuración, que el nuevo objeto CTelefono ha sido añadido a la colección. Esto 
sucede porque el control está enlazado a un origen de datos que no implementa la 
interfaz IBindingList (es el caso del objeto List<CTelefono>). Sin embargo, pue- 
de forzar la actualización del control llamando al método Refresh del objeto Cu- 
rrencyManager al que está vinculado el control. 


cm = listIfnos.BindingContext[colTfnos] as CurrencyManager; 


La línea de código anterior obtiene el objeto BindingManagerBase, al que 
está vinculado /istTfnos, que está asociado al origen de datos especificado. 


Según lo expuesto, modifique el código anterior como se indica a continua- 
ción: 


public partial class Forml : Form 
( 
private List<CTelefono> colTfnos; 
private CurrencyManager cm; 


public Forml() 
( 


Er 


n 


) 
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tializeComponent(); 


private void Forml_Load(object sender, EventArgs e) 


( 


colTfnos 











= FactorialTelefono.ObtenerColeccionCTelefono(); 


istTfnos.DataSource = colTfnos; 
listIfnos.DisplayMember = "Nombre"; 


ctTfnoSelec.DataBindings.Add("Text", colTfnos, "Telefono"); 


em = lis 
) 


private vo 
( 
decimal 
if (ctNo 
Deci 
{ 
colTfno 


cm.Pos1 


tIfnos.BindingContext[colTfnos] as CurrencyManager:; 


id btAñadir_Click(object sender, EventArgs e) 


tef = 0; 
bre.Text.Length != 0 48 ctTfno.Text.Length != 0 24 
al.TryParse(ctTfno.Text, out tef)) 


s.Add(FactoriaCTelefono.CrearCTelefono(ctNombre.Text, tef)); 
¡tion = em.Count; 





cm.Refresh(); 


) 
) 


private void btBorrar_Click(object sender, EventArgs e) 


( 
) 


private void btModificar_Click(object sender, EventArgs e) 


( 
) 


En el código anterior observamos que el controlador del evento Load ahora 
también obtiene el objeto CurrencyManager, al que está vinculado listIfnos, que 


está asociado a 


l origen de datos colTfnos, objeto que utilizaremos en el controla- 


dor del evento Click del botón Añadir para establecer como posición actual la co- 
rrespondiente al nuevo objeto añadido (se añade al final de la colección) y para 
invocar a su método Refresh para que la lista enlazada vuelva a llenarse. 


De acuerdo con lo expuesto hasta ahora, eliminar el elemento actualmente se- 
leccionado en la lista supone eliminar el elemento actual en la colección. Según 
esto, edite el controlador del evento Click del botón Borrar así: 


private void 
( 


if (cm.Posi 


btBorrar_Click(object sender, EventArgs e) 


tion < 0) return; 


colTfnos.RemoveAt(cm.Position); 
cm.Refresh():; 


} 
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Finalmente, la tarea del botón Modificar es permitir al usuario modificar cua- 
lesquiera de los datos del elemento actualmente seleccionado con los valores in- 
troducidos en las cajas de texto ctNombre y ctTfno. Por lo tanto, edite el controla- 
dor del evento Click de este botón como se indica a continuación: 


private void btModificar_Click(object sender, EventArgs e) 
( 
bool cambios = false; 


if (ctNombre.Text.Length != 0) 

( 
(cm.Current as Clelefono).Nombre = ctNombre.Text; 
cambios = true; 

) 

decimal tef = 0; 

if (ctTfno.Text.Length != 0 448 Decimal .TryParse(ctIfno.Text, out tef)) 

( 
(cm.Current as Clelefono).Telefono = tef; 
cambios = true; 

) 


if (cambios) cm.Refresh(); 











Este método modifica las propiedades del objeto CTelefono actualmente se- 
leccionado para las cuales el usuario ha introducido un nuevo valor en las cajas de 
texto correspondientes. 


BindingList 


Para construir listas de objetos que se vayan a utilizar como orígenes de datos, en 
general, es recomendable utilizar colecciones BindingList<7> ya que su interfaz 
IBindingList amplía la interfaz IList agregando las propiedades, métodos y even- 
tos necesarios para admitir un enlace de datos bidireccional. 


Así mismo, cuando se utiliza una colección BindingList<7>, los objetos de la 
misma deben implementar la interfaz INotifyPropertyChanged siempre que sea 
necesario que informen de los cambios. En este caso, BindingList<7> convertirá 
los eventos PropertyChanged a eventos ListChanged de tipo /temChanged, va- 
lor definido por la enumeración ListChangedType que especifica el modo en que 
ha cambiado la lista. 


Como ejemplo vamos a realizar otra versión de la aplicación anterior, pero 
utilizando ahora una colección BindingList. Para ello, cree una nueva aplicación 
denominada BindingList y diseñe la misma interfaz de la aplicación anterior: 
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a Form1 




















Persona 4 M 





























La clase BindingList admite un enlace de datos bidireccional, lo cual auto- 
matiza que los cambios en la lista (añadir o borrar elementos) se vean reflejados 
en los elementos de la interfaz gráfica enlazados y viceversa. Pero no sucederá lo 
mismo con los cambios que ocurran en las propiedades de los elementos de la lis- 
ta (propiedades Nombre y Telefono en el ejemplo) a no ser que estos implementen 
la interfaz INotifyPropertyChanged. Por lo tanto, añada al proyecto, en una car- 
peta Clases, la clase CTelefono con notificación de cambios especificada a conti- 


nuación: 
using System.ComponentModel'; 


namespace BindingList 


{ 


class CTelefono : INotifyPropertyChanged 
( 
private string _nombre = "Un nombre”; 
private decimal _telefono = 0; 


public event PropertyChangedEven 
private void Noti 
( 

if 








PropertyChanged(this, 
new Property 


| 
J 


public string Nombre 
{ 
get { 
set 
{ 
_nombre value; 
NotificarCambio("Nombre"); 


return _nombre; } 


) 
) 


public decimal Telefono 
( 


ficarCambio(stri 


this.PropertyChanged != nu 


tHandler PropertyChanged; 


ng nombreProp) 





1) 


ChangedEventArgs(nombreProp)):; 
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) 


} 


) 


get { return _telefono; } 
set 
( 
_telefono = value; 
NotificarCambio("Telefono"); 
) 


Después, añada una nueva clase FactoriaCTelefono que nos permita construir 


una lista de tipo BindingList< CTelefono> de objetos con valores cualesquiera. 


using System; 
using System.ComponentModel'; 


namespace BindingList 


( 


class FactoriaClelefono 


( 


private static BindingList<CTelefono>» _telefonos; 


// Nuevo CTelefono 
public static Clelefono CrearCTelefono(string nom, decimal tfn) 


( 


) 


CTelefono tfno = new CTelefono(); 
tfno.Nombre = nom; 

tfno.Telefono = tfn; 

return tfno; 


public static BindinglList<CTelefono> ObtenerColeccionCTelefono() 


( 


_telefonos = new BindingList<CTelefono»(); 
Random rnd = new Random():; 
for (int i = 1; i < 10; i++) 
{ 
_telefonos.Add(CrearCTelefono("Persona "+i, 
rnd.Next(636000000, 636999999))); 
) 


return _telefonos; 


Observe que, en esta nueva versión, la clase FactoriaCTelefono define un mé- 


todo ObtenerColeccionCTelefono que devuelve la colección BindingList de obje- 
tos CTelefono generada. 
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A continuación, siguiendo un proceso análogo al descrito en el apartado ante- 
rior, edite la clase Form! para definir un objeto BindingList<CTelefono> que ha- 
ga referencia a la colección creada desde FactoriaCTelefono.ObtenerColec- 
cionCTelefono que utilizaremos como origen de datos; enlazar los controles list- 
Tfnos, de tipo ListBox, y ctTfnoSelec, de tipo TextBox, con el origen de datos 
(todas estas operaciones las haremos en el controlador del evento Load de 
Forml); y escribir los controladores de los eventos de los botones Añadir, Borrar 
y Modificar. El resultado sería el siguiente: 


public partial class Forml : Form 
( 
private BindingList<CTelefono> colTfnos; 


public Forml() 
( 


e, 


nitializeComponent(); 


) 
private void Forml_Load(object sender, EventArgs e) 


colTfnos = FactoriaCTelefono.ObtenerColeccionCTelefono(); 
listTfnos.DataSource = colTfnos; 

listIfnos.DisplayMember = "Nombre"; 
ctTfnoSelec.DataBindings.Add("Text", colTfnos, "Telefono"); 








) 


private void btAñadir_Click(object sender, EventArgs e) 
( 





decimal tef = 0; 

if (ctNombre.Text.Length != 0 24 
ctTfno.Text.Length != 0 24 
Decimal.TryParse(ctIfno.Text, out tef)) 





( 





colTfnos.Add(FactoriaCTelefono.CrearCTelefono(ctNombre.Text, tef)); 
) 
) 


private void btBorrar_Click(object sender, EventArgs e) 
( 

int pos = listTfnos.SelectedIndex; 

1f (pos < 0) return; 

colTfnos.RemoveAt(pos); 
) 


private void btModificar_Click(object sender, EventArgs e) 
( 


int pos = listIfnos.SelectedIndex; 
if (ctNombre.Text.Length != 0) 


( 
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colTfnos[pos].Nombre = ctNombre.Text; 
) 
decimal tef = 0; 
if (ctIfno.Text.Length != 0 48 Decimal .TryParse(ctTfno.Text, out tef)) 
( 
colTfnos[pos].Telefono = tef; 
) 


Si ejecuta ahora la aplicación, observará que el origen de datos y los controles 
enlazados de la interfaz gráfica están perfectamente sincronizados. A diferencia 
de la versión anterior de esta aplicación, observe que ahora no necesitamos invo- 
car al método Refresh del objeto CurrencyManager asociado con el origen de 
datos para actualizar el control ListBox: BindingList realiza la sincronización, y, 
por lo tanto, la posición del elemento actual la obtenemos de la propiedad Selec- 
tedIndex del ListBox. 


BindingSource 


Anteriormente hemos visto que la clase BindingList<7> se puede utilizar para 
crear un enlace de datos bidireccional. Sin embargo, la solución más normal es 
utilizar la clase BindingSource. 


BindingSource simplifica el enlace a datos de los controles de un formulario 
al proporcionar administración de enlaces, notificación de cambios y otros servi- 
cios entre controles y orígenes de datos de Windows Forms, simplemente asig- 
nando el origen de datos a su propiedad DataSource. Para enlaces complejos, 
opcionalmente se puede asignar a su propiedad DataMember una columna o lista 
determinada del origen de datos y, finalmente, se enlazan los controles a Bin- 
dingSource. A partir de aquí, utilizando la funcionalidad proporcionada por este 
componente, será fácil interaccionar con los datos. Por ejemplo, la navegación y 
la actualización del origen de datos se realizan a través de métodos como Move- 
Next, MoveLast y Remove, y las operaciones como la ordenación y el filtrado se 
controlan por medio de las propiedades Sort y Filter. 


Como ejemplo vamos a realizar otra versión de la aplicación desarrollada an- 
teriormente en el apartado List, pero utilizando ahora un objeto BindingSource. 
Para ello, cree una nueva aplicación denominada Binding Source y diseñe la 
misma interfaz del proyecto List: 
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A continuación, añada al proyecto, en una carpeta Clases, las clases CTele- 
fono y FactoriaCTelefono que escribimos en el proyecto List. Recuerde que el 
método ObtenerColeccionCTelefono de la clase FactoriaCTelefono devuelve una 
colección de tipo List<CTelefono> que utilizaremos como origen de datos. 


El paso siguiente es enlazar los controles listTfmos de tipo ListBox y ctTfno- 
Selec de tipo TextBox con el origen de datos. Para ello, defina en la clase Form] 
los atributos privados colTfnos, que hará referencia a dicho origen de datos, y bs, 
que hará referencia al objeto BindingSource. Después, añada el controlador del 
evento Load del formulario y edítelo como se indica a continuación: 


public partial class Forml : Form 
( 
private List<CTelefono>» colTfnos; 
private BindingSource bs; 


public Forml() 
( 

In 
) 


lo 


tializeComponent(); 


private void Forml_Load(object sender, EventArgs e) 
( 
colTfnos = FactoriaCTelefono.ObtenerColeccionCTelefono(); 
bs = new BindingSource(); 
bs.DataSource = colTfnos; 
listTfnos.DataSource = bs; 
listIfnos.DisplayMember = "Nombre"; 
ctTfnoSelec.DataBindings.Add("Text", bs, "Telefono"); 








Observe que el método Form1_Load construye el origen de datos colTfnos, el 
objeto bs (BindingSource), y asigna colTfnos a la propiedad DataSource del ob- 
jeto bs. Después, asigna a la propiedad DataSource del control ListBox el objeto 
bs que establece el enlace entre este control y el origen de datos, y a su propiedad 
DisplayMember, el valor a mostrar, esto es, la propiedad Nombre de los objetos 
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CTelefono de la colección. Finalmente, establece un enlace entre la propiedad 
Text de la caja de texto ctTfmoSelec y la propiedad Telefono de los objetos CTele- 
fono de la colección, especificando como origen de datos bs. 


Si ejecuta ahora la aplicación, observará que los controles listTfmos y ctTfno- 
Selec ya están sincronizados con el origen de datos. 


Finalmente, vamos a escribir los controladores del evento Click de los boto- 
nes Añadir, Borrar y Modificar análogamente a como lo hicimos en la aplicación 
List: 


private void btAñadir_Click(object sender, EventArgs e) 
( 
decimal tef = 0; 
if (ctNombre.Text.length != 0 84 ctIfno.Text.Length != 0 84 
Decimal.TryParse(ctIfno.Text, out tef)) 

( 
colTfnos.Add(FactoriaCTelefono.CrearCTelefono(ctNombre.Text, tef)); 
bs.Position = DS- COUNTS 
bs.CurrencyManager.Refresh(); 

) 

) 





private void btBorrar_Click(object sender, EventArgs e) 
( 
if (bs.Position < 0) return; 


colTfnos.RemoveAt(bs.Position); 


bs.CurrencyManager.Refresh(); 


1 
S 





private void btModificar_Click(object sender, EventArgs e) 
( 

bool cambios = false; 

if (ctNombre.Text.lLength != 0) 


( 
(bs.Current as CTelefono).Nombre = ctNombre.Text; 
cambios = true; 
) 
decimal tef = 0; 
if (ctTfno.Text.Length != 0 448 Decimal .TryParse(ctIfno.Text, out tef)) 
( 
(bs.Current as CTelefono).Telefono = tef; 
cambios = true; 
) 
if (cambios) bs.CurrencyManager.Refresh(); 
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Observe en los métodos anteriores el uso de las propiedades Position, Cu- 
rrent y CurrencyManager del objeto BindingSource (su función suple a la 
ofrecida por el objeto CurrencyManager y sus propiedades). Position especifica 
el índice del elemento actual de la lista subyacente, Current permite acceder al 
elemento actual de la lista y CurrencyManager permite acceder al administrador 
de enlaces asociado a este BindingSource. 


ACCEDIENDO A LOS DATOS 


Por lo estudiado hasta ahora, hemos comprobado que el enlace de datos de .NET 
proporciona un método simple y coherente para que las aplicaciones interactúen 
con datos. También hemos visto que los orígenes de datos pueden estar basados 
en objetos de clases, en BindingSource o en objetos de datos de ADO.NET. Pues 
bien, en este apartado vamos a trabajar con orígenes de datos que sean coleccio- 
nes de objetos personalizados. Los datos serán tomados de una base de datos mo- 
delada por medio de las clases siguientes: 


























Q INotifyPropertyChanged Q INotifyPropertyChanged 
Alumno 2 Asignaturas lâ Asignatura B ListAlumnos E 
Class Class Class Class 
>» BindingList<Alumno> 
+ Campos + Campos + Campos 
= Propiedades = Propiedades = Propiedades 
Él BecaAlumno S ListaAsignaturas S IdAsignatura bbdd > 
 DirAlumno Tipo Æ NomaAsignatura 2 
El EstAlumno S Métodos Y Nota 
à nai + Campos 
ey umno % Asignaturas (+ 1 so... Métodos 
ley ListaAsigsObs j % Asignatura (+ 1 sob... = Propiedades 
A ESEASOS DES Y OnPropertyChanged ¿Alumnos 
ListaCoAsignaturas % ToString = Métodos 
' NomAlumno 
eS £ Eventos 39 bbdd 
ES %  PropertyChanged Y ObtenerAlumnoPorld 
% Alumno (+ 1 sobrec... 5° ObtenerAlumnos 
Y ObtenerAsignatura 
3Y ObtenerAsigsObsOps 
Y OnPropertyChanged 
% ToString 
= Eventos 
%  PropertyChanged 








Realizamos una breve descripción de este modelo de datos. Como hemos in- 
dicado anteriormente, vamos a trabajar con orígenes de datos que sean coleccio- 
nes de clases de objetos; en nuestro caso, estamos trabajando con una colección 
de alumnos (clase ListAlumnos: BindingList<4/umno>) que son objetos de la 
clase Alumno. Cada alumno tiene una colección de colecciones de asignaturas 
(ListaCoAsignaturas), que son objetos de la clase Asignaturas, y cada objeto 
Asignaturas contiene una colección de asignaturas (ListaAsignaturas), obligato- 
rias u optativas, que son objetos de la clase Asignatura. 
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La clase Alumno representa un alumno y proporciona varias propiedades para 
acceder a cada uno de los datos del mismo, más la propiedad ListaCoAsignaturas, 
que permite acceder a la colección BindingList<Asignaturas> correspondiente a 
la lista de colecciones de asignaturas, obligatorias y optativas, de las que se ha 
matriculado el alumno; la propiedad ListaAsigsObs, que permite acceder a la co- 
lección BindingList<Asignatura> de asignaturas obligatorias; la propiedad Lis- 
taAsigsOps, que permite acceder a la colección BindingList<4signatura> de 
asignaturas optativas; y el método ObtenerAsignatura, que devuelve el objeto 
Asignatura correspondiente al identificador de la asignatura pasado como argu- 
mento. 


La clase Asignaturas representa una colección de asignaturas, ListaAsignatu- 
ras, Obligatorias u optativas, característica especificada por su propiedad Tipo. 


La clase Asignatura, que representa una asignatura, básicamente presenta tres 
propiedades: el identificador de la asignatura, el nombre y la nota que se obtenga 
en la misma. 


La clase bbdd representa la base de datos. Define un objeto de la clase List- 
Alumnos derivada de la colección BindingList<4A/umno>; un objeto de esta clase 
será el que almacene todos los alumnos matriculados; esta colección será creada 
por el método privado ObtenerAlumnos cuando se haga referencia a la propiedad 
static Alumnos de la clase bbdd. También proporciona el método static Obtener- 
AlumnoPorld que devuelve el objeto Alumno correspondiente al identificador pa- 
sado como argumento. 


Puede echar un vistazo a la figura anterior y observar de una forma más am- 
plia todas las propiedades y métodos que proporciona cada clase. Las clases 
Alumno y Asignatura implementan la interfaz INotifyPropertyChanged para que 
los objetos de estas clases puedan notificar a la interfaz gráfica un cambio en el 
valor de cualquiera de sus propiedades, con el fin de que los elementos de dicha 
interfaz que estén enlazados con estos objetos puedan ser actualizados automáti- 
camente. La notificación la realizan los objetos de esas clases generando el evento 
PropertyChanged a través del método OnPropertyChanged que lleva asociado 
como datos el nombre de la propiedad cuyo valor ha cambiado. Recuerde que el 
enlace a datos necesita esta información para mantener la interfaz gráfica sincro- 
nizada con el objeto origen del enlace. 


Para crear este modelo de datos, simplemente hemos creado un proyecto Ba- 
seDeDatos de tipo Biblioteca de clases (Archivo > Nuevo proyecto > Biblioteca 
de clases) y, a continuación, hemos añadido cada una de las clases que hemos 
descrito anteriormente. De esta forma, cualquier otro proyecto que quiera utilizar 
este modelo, simplemente tendrá que añadir una referencia a la biblioteca genera- 
da: BaseDeDatos.dll (también puede añadir este proyecto a cualquier otra solu- 


CAPÍTULO 12: ENLACE DE DATOS EN WINDOWS FORMS 461 


ción, lo que le permitirá realizar modificaciones en esta biblioteca mientras cons- 
truye el proyecto que la utiliza o, simplemente, tener el código de la misma pre- 
sente). La base de datos la hemos simulado generando los datos desde el código 
mediante una clase factoría que hemos denominado bbdd. Esta clase tiene una 
propiedad static Alumnos que devuelve una colección ListAlumnos. Puede ver el 
código de la biblioteca BaseDeDatos en el CD del libro. 


Una vez creada la biblioteca de clases, vamos a crear un nuevo proyecto que 
utilice dicha biblioteca como origen de los datos. Según esto, cree un nuevo pro- 
yecto EnlaceDeDatosObjetos. Añada una referencia a la biblioteca BaseDeDa- 
tos.dll: vaya al explorador de soluciones, haga clic con el botón secundario del 
ratón sobre el nodo References, seleccione Agregar referencia, haga clic en la 
pestaña Examinar del diálogo que se visualiza, localice y seleccione BaseDeDa- 
tos.dll y haga clic en el botón Aceptar. Así mismo, si quiere tener presente el có- 
digo del proyecto BaseDeDatos puede añadir a la solución este proyecto: clic con 
el botón secundario del ratón sobre el nombre de la solución, seleccione Agregar 
> Nuevo proyecto y seleccione el proyecto BaseDeDatos. El resultado sería: 








A Solución 'EnlaceDeDatosObjetos' (2 prc a 
4 E BaseDeDatos 
a] Properties 


| 
= References | 
#) Alumno.cs zl 


4] Asignatura.cs 
¿] Asignaturas.cs 
$] bbdd.cs 
2) ClassDiagram1.cd O 
] ListAlumnos.cs 

a ¡ZA EnlaceDeDatosObjetos 
a] Properties 





a | References 
«3 BaseDeDatos 
«3 Microsoft.CSharp 
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F] Explorad... LATA AEE A 








El objetivo inicial de este proyecto es mostrar la lista de alumnos de la base 
de datos. Esto lo podemos hacer utilizando un control DataGridView según 
muestra la figura siguiente: 
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Para ello, la aplicación, a partir de la supuesta base de datos, generará el 
modelo de datos que dará lugar al origen de datos y enlazará los controles de su 
interfaz gráfica con ese origen de datos. Gráficamente lo podemos ver así: 


INTERFAZ GRÁFICA DE USUARIO (GUI) 


Código subyacente 
Modelo de datos 


Un modelo de datos es una vista programable, fuertemente tipada, de los da- 
tos subyacentes en una base de datos, por ejemplo, un modelo basado en Entity 
Data Model (este concepto lo veremos con más detalle en capítulos posteriores), 
que dará lugar a los orígenes de datos necesarios en una aplicación. 












Los orígenes de datos representan los datos disponibles para la aplicación. Es- 
tos orígenes de datos pueden ser mostrados en la ventana Orígenes de datos de 
Visual Studio y utilizar esta ventana para crear controles enlazados a datos en la 
interfaz de usuario arrastrando, simplemente, elementos desde la misma hasta la 
superficie de diseño del proyecto. 


Ventana de orígenes de datos 


Los orígenes de datos representan los datos con los que deseamos trabajar en 
nuestra aplicación y se pueden construir a partir de objetos, de bases de datos y de 
servicios. Para crear y modificar orígenes de datos, Visual Studio proporciona un 
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asistente que podemos ejecutar seleccionando la opción Agregar nuevo origen de 
datos, bien desde el menú Proyecto de Visual Studio, o bien desde la ventana 
Origenes de datos que podemos visualizar seleccionando la opción Ver > Otras 
ventanas > Orígenes de datos: 





| My 
Asistente para la configuración de orígenes de datos Le [esas] 


aL Elegir un tipo de origen de datos 


¿De dónde obtendrá la aplicación los datos? 


Base de datos Servicio Objeto SharePoint 








Permite elegir objetos que se pueden usar posteriormente para generar controles enlazados a datos, 














El primer paso consiste en elegir el tipo de origen de datos; para nuestro 
ejemplo será Objeto ya que nuestro modelo de datos está basado en objetos. Ha- 
cemos clic en Siguiente para avanzar al siguiente paso donde podremos seleccio- 
nar los objetos de datos de nuestro modelo susceptibles de ser utilizados como 
orígenes de datos en nuestra aplicación, según muestra la figura siguiente: 


Asistente para la configuración de orígenes de datos bek) 


aL Seleccionar los objetos de datos 
) 


Expanda los ensamblados y los espacios de nombres a los que se hace referencia para seleccionar objetos. Si falta 
un objeto en un ensamblado al que se hace referencia, cancele el asistente y recompile el proyecto que contiene el 
objeto. 








¿A qué objetos desea enlazar? 
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Una vez finalizado el trabajo con el asistente, la ventana Orígenes de datos 
mostrará los orígenes de datos creados: 
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En la figura anterior, la de la izquierda muestra los orígenes de datos Alumno, 
Asignatura, Asignaturas y ListAlumnos. Si expandimos el objeto ListAlumnos ve- 
remos sus propiedades; en este caso, por tratarse de una colección de objetos 
Alumno, se mostrarán las propiedades de estos objetos. También observamos un 
icono a la izquierda que representa el control (DataGridView, Detalles o Nin- 
guno) que se creará cuando arrastremos ese elemento (elemento simple o colec- 
ción) sobre la superficie de diseño; dicho control puede ser seleccionado de la 
lista que muestra cada elemento en la jerarquía según se puede ver en la figura de 
la derecha. Por ejemplo, el elemento ListAlumnos (lista de alumnos) muestra a la 
izquierda un icono DataGridView; entonces, al arrastrarlo sobre el formulario 
(hágalo) 





dep |» bli X A 




















Ey listAlumnosBindingSource PlistAlumnosBindingNavigator 
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se creará una rejilla (enlazada a un origen de datos ficticio, como veremos a con- 
tinuación) con una columna por cada propiedad que representa un dato elemental 
(no una colección). Evidentemente, independientemente de las columnas de datos 
mostradas, cada fila se corresponderá con un objeto Alumno con todas sus propie- 
dades (elementales y complejas), a las que podremos hacer referencia. 


A continuación puede configurar la rejilla según estudiamos en el capítulo 
Tablas y árboles; por ejemplo, puede personalizar las cabeceras de las columnas 
así como su ancho y puede definir la primera columna de solo lectura. 


La operación de arrastrar que acabamos de realizar ha generado una gran can- 
tidad de código en el fichero Form1.Designer.cs que podemos examinar, simple- 
mente para saber cómo deberíamos proceder si el diseño de la interfaz gráfica y el 
enlace a datos lo tuviéramos que realizar manualmente. 


Observando la figura anterior, podemos deducir que se ha generado código 
para definir el control BindingNavigator (barra de navegación enlazada a datos) 
así como para los controles que lo componen (de tipo ToolStripButton, ToolStri- 
pLabel, ToolStripTextBox y ToolStripSeparator), para el control DataGridView 
y las columnas que lo componen (de tipo DataGridViewTextBoxColumn y Data- 
GridViewCheckBoxColumn) y para el objeto BindingSource que actuará como 
intermediario entre el origen de datos y los controles enlazados a datos. 


La idea de arrastrar el elemento ListAlumnos sobre el formulario es crear una 
rejilla enlazada a este origen de datos (colección de objetos Alumno) que muestre 
la lista de alumnos. Pero, observando el código vemos que la propiedad Data- 
Source de la rejilla no tiene como valor directamente el objeto colección, sino que 
tiene como valor el objeto BindingSource, 


listAlumnosDataGridView.DataSource = listAlumnosBindingSource; 


y la propiedad DataSource del BindingSource es quien tiene asignado el origen 
de datos, aunque no exactamente, porque aún no está creado, por eso, según 
muestra la línea de código siguiente, se le ha asignado el objeto Type devuelto 
por typeof, que proporciona información acerca de los metadatos del tipo pasado 
como argumento, en este caso del tipo Alumno (constructores, métodos, campos, 
propiedades y eventos). Esto permite al DataGridView conocer los metadatos del 
objeto Alumno sin tener que esperar a que los datos reales estén presentes para 
construir las columnas, situación que se produce durante el diseño (pruebe a co- 
mentar la línea siguiente y observará cómo durante el diseño no se muestran las 
columnas de la rejilla). 


listAlumnosBindingSource.DataSource = typeof(BaseDeDatos.Alumno); 
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Según lo expuesto, para que el DataGridView muestre los datos del origen 
de datos, tendremos que crear la colección ListAlumnos y asignársela a la propie- 
dad DataSource del BindingSource: 


using System.Windows.Forms; 
using BaseDeDatos; 


namespace EnlaceDeDatosObjetos 
( 
public partial class Forml : Form 
( 
public Forml() 
( 
InitializeComponent(); 
listAlumosBindingSource.DataSource = bbdd.Alumnos; 
) 
) 
) 


Si ahora ejecuta la aplicación observará que la rejilla muestra los datos co- 
rrespondientes a la colección de objetos Alumno. También puede verificar que la 
barra de navegación está operativa; pruebe a añadir un nuevo alumno, a borrarlo o 
a modificar sus datos. Si lo desea puede quitar esta barra, para ello basta con que 
elimine el elemento /istAlumnosBindingNavigator que se muestra en la bandeja 
del diseñador, o bien puede ocultarla. 


Los cambios que hagamos sobre los datos en la interfaz gráfica se propagarán 
a la colección y viceversa (puede probar esto añadiendo un segundo Data- 
GridView conectado al mismo origen de datos). Esto es así porque la clase Bin- 
dingList<7> admite un enlace de datos bidireccional y porque las clases Alumno 
y Asignatura implementan la interfaz INotifyPropertyChanged. 


Vinculación maestro-detalle 


Un diseño de tipo maestro-detalle incluye dos partes: una vista que muestra una 
lista de elementos, normalmente una colección de datos, y una vista de detalles 
que muestra los detalles acerca del elemento que se selecciona en la lista anterior. 
Por ejemplo, este libro es un ejemplo de diseño de tipo maestro-detalle, donde la 
tabla de contenido es la vista que muestra una lista de elementos y el te- 
ma/apartado escrito es la vista de detalles. 


La figura siguiente muestra con claridad lo que se pretende conseguir con este 
tipo de diseño. Observe: la ventana, inicialmente, presenta la lista de alumnos, en 
este caso con sus datos, el usuario selecciona un alumno y automáticamente se 
completa la lista de tipos de asignaturas en los que ese alumno participa, el usua- 
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rio selecciona un tipo de asignaturas y se completa la lista de asignaturas (de las 
que el alumno está matriculado en cuanto a ese tipo se refiere) y, finalmente, el 
usuario selecciona la asignatura de la cual desea conocer la nota. Como habrá de- 
ducido, cada paso en la secuencia del proceso es un detalle del anterior. 
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Vamos a implementar este ejemplo como continuación de la aplicación que 
empezamos a desarrollar en el apartado anterior. Entonces, partiendo de que la lis- 
ta de alumnos ya la tenemos, lo que tendremos que hacer básicamente será añadir 
un nueva rejilla para los tipos de asignaturas correspondientes al alumno seleccio- 
nado, otra para las asignaturas correspondientes al tipo de asignaturas selecciona- 
do y un control de texto para mostrar la nota de la asignatura seleccionada (al 
utilizar una rejilla para mostrar la lista de asignaturas, es evidente que esta puede 
mostrar también la columna Nota, pero nuestro diseño será el propuesto). 


Partimos de que disponemos de un origen de datos referenciado por el ele- 
mento listAlumnosBindingSource definido en la aplicación así: 


public Forml() 
( 
InitializeComponent(); 
listAlumnosBindingSource.DataSource = bbdd.Alumnos; 
} 
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No pierda de vista que el origen de datos establecido es una colección de tipo 
ListAlumnos de objetos Alumno y que este objeto tiene las propiedades mostradas 
en la figura siguiente, entre ellas ListaCoAsignaturas: 
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El siguiente paso es mostrar los tipos de asignaturas del alumno seleccionado 
en la rejilla anterior. La propiedad ListaCoAsignaturas del alumno seleccionado 
es una colección de objetos de tipo Asignaturas, los cuales tienen dos propieda- 
des: ListaAsignaturas y Tipo. Entonces, según lo estudiado hasta ahora, si arras- 
tramos la propiedad ListaCoAsignaturas sobre el formulario, se creará una rejilla 
con una columna Tipo; evidentemente, cada fila se corresponderá con un objeto 
Asignaturas con todas sus propiedades, a las que podremos hacer referencia. 
Echemos una ojeada al código que se ha generado después de esta operación. 


Observando el formulario, podemos deducir que se ha generado código para 
definir el control DataGridView así como para las columnas que lo componen 
(una de tipo DataGridViewTextBoxColumn), y para el objeto BindingSource, 
listaCoAsignaturasBindingSource, que actuará como intermediario entre el origen 
de datos y esta rejilla. Analizando este código vemos también que la propiedad 
DataSource del BindingSource se ha establecido con el origen de datos /istA- 
lumnosBindingSource definido para la primera rejilla, y su propiedad DataMem- 
ber, con la lista ListaCoAsignaturas (cuando DataSource contiene varias listas, o 
tablas, la propiedad DataMember permite especificar cuál de ellas se establecerá 
como origen de datos). 


"ListaCloAsignaturas"”; 
listAlumnosBindingSource; 


listaCoAsignaturasBindingSource.DataMember 
listaCoAsignaturasBindingSource.DataSource 
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Para tener una idea más clara de lo que estamos haciendo, una alternativa po- 
dría ser la siguiente: añadir el controlador del evento CellClick de /istAlumnos- 
DataGridView, que se produce cuando el usuario hace clic en cualquier parte de 
una celda en el instante de seleccionar un alumno, para que establezca el origen de 
datos de listaCoAsignaturasBindingSource con la lista ListaCoAsignaturas del 
alumno actualmente seleccionado: 


listaCoAsignaturasBindingSource.DataSource = 
typeof(BaseDeDatos.Asignaturas); 
listaCoAsignaturasDataGridView.DataSource = 
listaloAsignaturasBindingSource; 

£I 


private void listAlumnosDataGridView_CellClick(object sender, 

DataGridViewCellEventArgs e) 

{ 

if (e.RowIndex < 0) return; 

Alumno al = listAlumnosBindingSource.Current as Alumno; 

listaCoAsignaturasBindingSource.DataSource = 
al.ListaCoAsignaturas; 





El siguiente paso es mostrar las asignaturas correspondientes al tipo de asig- 
naturas seleccionado en la rejilla anterior. Para ello estableceremos como origen 
de datos del contenedor de esta rejilla el elemento (Asignaturas) seleccionado en 
la lista anterior. Un objeto Asignaturas contiene objetos Asignatura (los que tiene 
que mostrar esta rejilla); por lo tanto, arrastre la propiedad ListaAsignaturas de 
los objetos Asignaturas de ListaCoAsignaturas sobre el formulario. Se creará una 
rejilla con tres columnas, las correspondientes a las propiedades de los objetos 
Asignatura de esta lista. Echemos una ojeada al código que se ha generado. 


Observando el formulario, podemos deducir que se ha generado código para 
definir el control DataGridView así como para las columnas que lo componen, y 
para el objeto BindingSource, listaAsignaturasBinding8ource, que actuará como 
intermediario entre el origen de datos y esta rejilla. Analizando este código vemos 
también que la propiedad DataSource del BindingSource se ha establecido con 
el origen de datos, listaCoAsignaturasBindingSource, de la rejilla anterior, y su 
propiedad DataMember, con la lista ListaAsignaturas: 


listaAsignaturasBindingSource.DataMember = "ListaAsignaturas"; 
listaAsignaturasBindingSource.DataSource = listaCoAsignaturasBindingSource; 


En esta rejilla solo deseamos que aparezca el identificador y el nombre de las 
asignaturas. Por lo tanto, configure la rejilla para eliminar la columna correspon- 
diente a la nota. 
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Finalmente, hay que mostrar la nota de la asignatura seleccionada en la rejilla 
anterior. Esto quiere decir que la asignatura seleccionada de la colección de obje- 
tos Asignatura que muestra la rejilla anterior será el origen de datos del contene- 
dor que mostrará este valor. Un objeto Asignatura tiene, entre otras, la propiedad 
Nota, que mostraremos en un TextBox. Por lo tanto, arrastre la propiedad Nota de 
los objetos Asignatura de ListaAsignaturas sobre el formulario. Se creará una caja 
de texto, la cual mostrará la nota. Si ahora analizamos el código generado después 
de esta operación, veremos que se ha añadido a la colección DataBindings del 
TextBox un nuevo enlace entre la propiedad Text de este control y la propiedad 
Nota del objeto Asignatura actualmente seleccionado, que tiene como origen de 
datos listaAsignaturasBindingSource: 


notaTextBox.DataBindings.Add(new Binding( 
"Text", listaAsignaturasBindingSource, "Nota", true)); 


Ejecute ahora la aplicación y observe los resultados. Comprobará que todos 
los controles enlazados a datos de la interfaz gráfica están perfectamente sincroni- 
zados y que, gracias al asistente para la configuración de orígenes de datos, nues- 
tra aportación ha sido escribir una línea de código, la que proporciona la colección 
de objetos Alumno. También puede verificar que las operaciones de añadir, borrar 
o modificar datos funcionan perfectamente. 


Operaciones con los datos 


Cualquier interacción con los datos subyacentes se realiza a través de los miem- 
bros del objeto BindingSource, como ya hemos visto y como seguiremos estu- 
diando a continuación. 


Para ello, vamos a crear un nuevo proyecto que utilice la biblioteca BaseDe- 
Datos creada anteriormente como origen de los datos. Este proyecto, inicialmente, 
será igual al construido en el apartado anterior. Por lo tanto, cree un nuevo pro- 
yecto OperacionesConDatos, añada a la solución generada para este proyecto el 
proyecto BaseDeDatos que da lugar a la biblioteca mencionada, añada al proyecto 
OperacionesConDatos una referencia a esta biblioteca y complételo para que, ini- 
cialmente, realice la misma función que el proyecto EnlaceDeDatosObjetos. Par- 
tiendo de esta base, vamos a estudiar cómo realizar operaciones de navegación, 
ordenación, filtrado y búsqueda. 


Elemento actual 
El elemento actual está siempre referenciado por la propiedad Current de Bin- 


dingSource y la lista completa mediante su propiedad List. Como ejemplo, po- 
demos escribir el controlador del evento CellClick de la rejilla que muestra la 


CAPÍTULO 12: ENLACE DE DATOS EN WINDOWS FORMS 471 


lista de alumnos, que se produce cuando el usuario hace clic en cualquier parte de 
una celda, para que muestre en una ventana de mensaje el nombre del alumno so- 
bre cuya fila acabamos de hacer clic. 


private void listAlumnosDataGridView_CellClick(object sender, 
DataGridViewCellEventArgs e) 
( 

if (e.RowIndex < 0) return; 

Alumno alumActual = listAlumosBindingSource.Current as Alumno; 


MessageBox.Show(alumActual.NomAlumno); 


1 
J 


Este método obtiene el elemento actualmente seleccionado de la colección de 
datos, un objeto Alumno, y muestra el nombre del alumno. 


La diferencia entre el evento CellClick y CellContentClick es que este últi- 
mo se genera cuando se hace clic en el contenido de la celda. 


Navegar 


El sistema de navegación se implementa a través de los métodos MoveFirst, Mo- 
veLast, MoveNext y MovePrevious de BindingSource. Por ejemplo, suponien- 
do que el formulario de nuestra aplicación ejemplo tuviera un botón de pulsación 
identificado por btSiguiente para permitir al usuario avanzar al siguiente elemento 
de la colección de datos subyacente, tendríamos que escribir el controlador de su 
evento Click así: 


private void btSiguiente_Click(object sender, EventArgs e) 
( 


listAlumosBindingSource.MoveNext(); 


1 
J 


El método MoveNext de BindingSource avanza al siguiente elemento en el 
origen de datos. 


Como ejercicio, vamos a personalizar la interfaz gráfica sustituyendo la barra 
de navegación por nuestros propios controles, según muestra la figura siguiente. 
Observe que esta nueva versión ya no presenta la barra de navegación y que se 
han añadido cuatro botones para realizar las operaciones de posicionarse en el 
primer o último alumno y añadir o borrar un alumno, así como una etiqueta para 
mostrar la posición de la fila actual y el número total de filas. 


Según lo expuesto, oculte la barra BindingNavigator asignando a su propie- 
dad Visible el valor false; de esta forma podremos seguir utilizando su funciona- 


472 ENCICLOPEDIA DE MICROSOFT VISUAL Cf 


lidad, si fuera necesario. Después, añada los botones y la etiqueta a los que hemos 
hecho referencia en el párrafo anterior. 
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Con este nuevo diseño, tenemos que escribir el código necesario para que ca- 
da uno de los controles añadidos realice su función. 


Empecemos por la etiqueta; debe mostrar la posición actual y el número total 
de filas nada más iniciar la aplicación, 


public Form1() 

{ 
InitializeComponent(); 
listAlumnosBindingSource.DataSource = bbdd.Alumnos; 
MostrarPosicion(); 

) 


y cada vez que cambie la posición actual; en este caso, utilizaremos el controlador 
del evento CellEnter que se produce cada vez que una celda recibe el foco de en- 
trada: 


private void listAlumnosDataGridView_CellEnter(object sender, 
DataGridViewCellEventArgs e) 
( 
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MostrarPosicion(); 
) 


El método MostrarPosicion calcula el número total de elementos del origen 
de datos y la posición del elemento actualmente seleccionado (el elemento 1 está 
en la posición 0) y, en función de estos datos, la etiqueta e£Posicion mostrará el li- 
teral “¡Pos de ¡Total”. Añada este método a la clase Form]: 


private void MostrarPosicion() 


( 











// Total elementos 

int iTotal = listAlumnosBindingSource.Count:; 

// Número (1, 2, ...) de elemento 

int iPos; 

if (iTotal == 0) 
etPosicion.Text = "0 de 0"; 

else 

( 
iPos = listAlumnosBindingSource.Position + 1; 
// Mostrar información en la etiqueta 
etPosicion.Text = ¡iPos.ToString() +" de " + iTotal.ToString(); 


) 
) 


Continuemos con los botones. El botón Primero situará la posición actual en 
la primera fila de la rejilla, para lo cual el controlador de su evento Click invocará 
al método MoveFirst del origen /istAlumnosBindingSource y el botón Último lo 
situará en la última fila de la rejilla invocando al método MoveLast: 


private void btPrimero_Click(object sender, System.EventArgs e) 


listAlumnosBindingSource.MoveFirst(); 


private void btUultimo_Click(object sender, System.EventArgs e) 

















listAlumnosBindingSource.MoveLast(); 


Los botones Añadir y Borrar simplemente realizarán la misma acción que sus 
homólogos de la barra de navegación. Para ello, edite los controladores de su 
evento Click como se indica a continuación: 


private void btAñadir_Click(object sender, System.EventArgs e) 
( 

bindingNavigatorAddNewltem.PerformClick(); 
) 
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private void btBorrar_Click(object sender, System.EventArgs e) 


( 
bindingNavigatorDeleteltem.PerformClick(); 


} 


El método PerformClick genera un evento Click para el botón que lo invoca; 
esto es, los botones Añadir y Borrar se limitan a hacer clic sobre sus homólogos 
en la barra de navegación que tenemos oculta. 


Ordenación, filtrado y búsqueda 


Con frecuencia una aplicación necesita buscar elementos en una lista, mostrar una 
lista ordenada, o filtrar los elementos de una lista para de alguna forma limitar la 
cantidad de datos que se muestran. Por lo estudiado hasta ahora, sabemos que el 
objeto BindingSource proporciona estas operaciones; sin embargo, no las imple- 
menta por sí mismo, sino que requiere del soporte del origen de datos. Esto es, es- 
tas operaciones estarán disponibles cuando la lista subyacente implemente la 
interfaz IBindingList o IBindingListView. Aun así, no todas las listas que im- 
plementan estas interfaces soportan todas estas operaciones; por eso, lo mejor es 
comprobarlo mediante las propiedades de BindingSource siguientes: 


e SupportsSorting. Devuelve un valor true/false que indica si el origen de da- 
tos admite la ordenación. Por ejemplo: 


if (listAlumosBindingSource.SupportsSorting) 
listAlumnosBindingSource.Sort = "BecaAlumno"'; 


e SupportsAdvancedSorting. Devuelve un valor true/false que indica si el 
origen de datos admite la ordenación de varias columnas. Por ejemplo: 


if (listAlumosBindingSource.SupportsAdvancedSorting) 
listAlumosBindingSource.Sort = "BecaAlumno DESC, NomAlumno ASC"; 


e SupportsFiltering. Devuelve un valor true/false que indica si el origen de 
datos admite el filtrado. Por ejemplo: 


if (IistAlumosBindingSource.SupportsFiltering) 
listAlumnosBindingSource.Filter = "BecaAlumno=true"'; 


e SupportsSearching. Devuelve un valor true/false que indica si el origen de 
datos permite buscar con el método de Find. Por ejemplo: 


if (IistAlumosBindingSource.SupportsSearching) 
listAlumosBindingSource.Position = vista.Find("BecaAlumno", true); 
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e SupportsChangeNotification. Devuelve un valor true/false que indica si el 
origen de datos admite la notificación de cambios. 


En ADO.NET, la clase DataView implementa IBindingListView (esta inter- 
faz extiende la interfaz IBindingList proporcionando funciones avanzadas de or- 
denación y filtrado) y por lo tanto, lo normal es que tengamos acceso a las 
operaciones de ordenación, filtrado y búsqueda. 


Según lo expuesto, para probar las capacidades de la lista subyacente del ob- 
jeto listAlumnosBindingSource de nuestra aplicación podemos añadir una casilla 
de verificación por cada una de las operaciones ordenar, filtrar y buscar e imple- 
mentar el controlador que responda al evento CheckedChanged de cada una de 
ellas, escribiendo el código de los ejemplos que acabamos de ver. Puede también 
añadir una caja de texto que nos permita especificar el contenido por el que se 
desea hacer la búsqueda. Después de todo este trabajo comprobará que ninguna de 
estas operaciones está soportada, y tampoco se pueden ordenar ascendente o des- 
cendentemente las columnas haciendo clic en su cabecera, a pesar de que la pro- 
piedad SortMode de cada una de ellas vale Automatic. 
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Resumiendo, las colecciones de System.Collections, como la colección 
List<7> que hemos utilizado anteriormente, no proporcionan ninguna de las inter- 
faces necesarias para buscar, ordenar o filtrar. También hemos visto que .NET 
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aporta BindingList<7> como una implementación de IBindingList, pero, por ser 
una implementación genérica, no tiene implementada ninguna de las operaciones 
mencionadas. La solución sería construir una clase de colección que implemente 
la interfaz IBindingListView, aunque no resulta fácil hacerlo, y esto fue lo que 
hizo Andrew Davey cuando escribió la clase BindingListView<7> que podemos 
descargar de http://blw.sourceforge.net. Para utilizarla, basta con descargar la bi- 
blioteca Equin.ApplicationFramework.BindingListView.dll y añadir al proyecto 
una referencia a la misma. 


BindingListView 


La clase BindingListView, del espacio de nombres Equin.ApplicationFrame- 
work, permite construir una vista (de una colección que implemente la interfaz 
IList) que soporta las operaciones de ordenación, filtrado y búsqueda, y que se 
puede enlazar a un DataGridView. Se trata de una clase que se puede utilizar de 
forma equivalente a como se utiliza un DataView con un DataTable de 
ADO.NET, según veremos en capítulos posteriores. 


Una vista de colección es un objeto situado un nivel por encima de la colec- 
ción proporcionada por el origen del enlace. Dicha vista permite navegar y mos- 
trar la colección en función de las consultas de ordenación, filtrado y búsqueda, 
sin tener que cambiar la propia colección subyacente en el origen. 


Por ejemplo, suponiendo que ya hemos añadido a nuestro proyecto Operacio- 
nesConDatos una referencia a la biblioteca Equin.ApplicationFramework.Bin- 
dingListView.dll, vamos a obtener la vista del origen de datos que nos permita 
realizar las operaciones de ordenación, filtrado y búsqueda. Para ello, añada el si- 
guiente código a la clase Form] que crea el objeto vista a partir de la colección 
devuelta por la expresión bbdd.Alumnos. 


using BaseDeDatos; 
using Equin.ApplicationFramework; 
namespace OperacionesConDatos 
( 
public partial class Forml : Form 
( 
BindingListView<Alumno> vista; 


public Forml() 

( 
InitializeComponent(); 
vista = new BindingListView<Alumno>(bbdd.Alumnos); 
listAlumosBindingSource.DataSource = vista; 
MostrarPosicion(); 
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// 


Observe que ahora el objeto listAlumnosBindingSource tiene como origen de 
datos la vista BindingListView de la colección BindingList<4/umno>. Ejecute la 
aplicación y observe como ahora ya puede ordenar las filas del DataGrid ascen- 
dente o descendentemente por la columna que desee. 


Una alternativa al código anterior es la siguiente: 


public partial class Forml : Form 
( 
AggregateBindinglistView<Alumno> vista; 


public Forml() 

( 
InitializeComponent(); 
vista = new AggregateBindingListView<Alumno>():; 
vista.SourceLists.Add(bbdd.Alumnos); 
listAlumnosBindingSource.DataSource = vista; 
MostrarPosicion(); 


1! 


La clase AggregateBindingListView permite construir una vista inicialmente 
vacía, para más adelante vincularla con una colección. 


Otra posibilidad es crear una vista de una colección que es miembro de un 
elemento de la colección origen de los datos. Por ejemplo: 


BindingList<Alumno> alums = bbdd.Alumnos; 


AggregateBindingListView<Asignaturas>» vista = 
new AggregateBindingListView<Asignaturas>(); 


// Hacer que la vista sea de la lista de objetos Asignaturas 
vista.DataMember = "ListaCloAsignaturas"; 
vista.SourceLists = alums; 


listaCoAsignaturasBindingSource.DataSource = vista; 














Este ejemplo crea una vista de la colección ListaCoAsignaturas que es miem- 
bro de un objeto Alumno de la colección alums. 
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Elemento actual de la vista 


El elemento actual está siempre referenciado por la propiedad Current de Bin- 
dingSource, pero cuando obtenemos la vista de la colección subyacente, cada 
elemento de la colección es envuelto por un objeto de la clase ObjectView<T>, 
quedando referenciado el elemento por la propiedad Object de dicho objeto. Co- 
mo ejemplo, podemos escribir el controlador del evento CellClick de la rejilla que 
muestra la lista de alumnos para que muestre el nombre del alumno seleccionado: 


private void listAlumnosDataGridView_CellClick(object sender, 

DataGridViewCellEventArgs e) 

( 
if (e.RowIndex < 0) return; 
ObjectView<Alumno> obVista = 

listAlumnosBindingSource.Current as ObjectView<Alumno>; 

Alumno alumActual = obVista.Object; 
MessageBox.Show(alumActual.NomAlumno); 








Ordenar 


Una de las operaciones admitidas por la vista es la ordenación de sus elementos 
(recuerde que la vista siempre se sitúa un nivel por encima de la colección). Pues 
bien, la forma más sencilla de ordenar los elementos que mostrará la vista es a 
través de su método ApplySort o de la propiedad Sort del BindingSource. En 
ambos casos, especificaremos una cadena que describe los nombres de las colum- 
nas (se distinguen mayúsculas y minúsculas), separadas por comas, utilizadas en 
la operación de ordenación, junto con la dirección de ordenación, que es ascen- 
dente (ASC) de forma predeterminada. También se puede especificar que la orde- 
nación sea descendente: DESC. 


Como ejemplo, vamos a escribir el controlador del evento CheckedChanged 
de la casilla de verificación “Ordenar” para que, si es posible, ordene los elemen- 
tos de la vista primero por la columna BecaAlumno descendentemente (así agru- 
pamos todos los alumnos que tienen beca en el orden “True”, “False”) y después 
por la columna NomAlumno ascendentemente: 


private void cvOrdenar_CheckedChanged(object sender, 
System.EventArgs e) 
( 

if (!l1istAlumosBindingSource.SupportsAdvancedSorting) return; 


if (cvOrdenar.Checked == true) 
vista.ApplySort("BecaAlumno DESC, NomAlumno ASC"); 
else 


vista.ApplySort("IdAlumno"); 
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Observe que este método alterna entre dos vistas: si la casilla de verificación 
está marcada, se presentará la vista ordenada, y si no, se mostrará en su estado 
inicial. A continuación se muestra la otra alternativa: 


if (!l1istAlumosBindingSource.SupportsAdvancedSorting) return; 
if (cvOrdenar.Checked == true) 

listAlumnosBindingSource.Sort = "BecaAlumno DESC, NomAlumno ASC"; 
else 

listAlumnosBindingSource.Sort = "IdAlumno"; 


Filtrar 


Una vista también tiene la capacidad de filtrar los elementos provenientes de la 
colección subyacente. Esto es, se puede crear una vista con los elementos de la 
colección que cumplan unos determinados criterios. Para especificar tales condi- 
ciones necesitamos vincular la propiedad Filter de la vista con el método que se 
utilice para determinar qué elementos pertenecerán a la misma. Como esta pro- 
piedad es de tipo Predicate<7> o /ItemPilter<T> podemos implementar un mé- 
todo anónimo acorde al delegado: delegate bool Predicate<in T>(T obj). 


Como ejemplo, vamos a escribir el controlador del evento CheckedChanged 
de la casilla “Filtrar” para que la vista muestre solo los alumnos que tienen beca. 


private void cvFiltrar_CheckedChanged(object sender, EventArgs e) 

( 

if (!listAlumosBindingSource.SupportsFiltering) return; 
if (cvFiltrar.Checked == true) 

( 

vista.ApplyFilter(delegate(Alumno alum) 

( 





return alum.BecaAlumno == true; 
DE 
) 
else 
vista.RemoveFilter(); 


Observe que la condición impuesta para que una fila se incluya en la vista es 
que el valor de la columna BecaAlumno sea true, y que el método alterna entre 
dos vistas: si la casilla de verificación está marcada, se presentará la vista con el 
contenido filtrado, y si no, se mostrará el contenido sin filtrar. 


Buscar 


Otra de las operaciones admitidas por la vista es la búsqueda de un elemento. Pues 
bien, la forma más sencilla de buscar un elemento es a través del método Find de 
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la propia vista o del objeto BindingSource. En ambos casos, especificaremos una 
cadena que describe el nombre de la columna utilizada en la operación de búsque- 
da (se distinguen mayúsculas y minúsculas), junto con el objeto a buscar. 


Como ejemplo, vamos a escribir el controlador del evento CheckedChanged 
de la caja de texto ctBuscar para que, si es posible, localice el primer elemento de 
la vista que contenga en la columna NomAlumno la cadena escrita en dicha caja 
de texto: 


private void ctFiltrarBuscar_TextChanged(object sender, 
System.EventArgs e) 
( 


=i 


(!listAlumnosBindingSource.SupportsSearching) return; 

f (cvBuscar.Checked == true) 

listAlumnosBindingSource.Position = 
vista.Find("NomAlumno", ctBuscar.Text); 


saidi 








else 
ctBuscar.Text = ""; 


Observe que si la casilla de verificación no está marcada, la caja de texto 
permanecerá vacía. A continuación se muestra la otra alternativa: 


if (!listAlumnosBindingSource.SupportsSearching) return; 
if (cvBuscar.Checked == true) 
listAlumnosBindingSource.Position = 
listAlumnosBindingSource.Find("NomAlumno", ctBuscar.Text); 
else 
ctBuscar.Text = ""; 


Datos introducidos por el usuario 


El fin de una aplicación puede ser simplemente procesar datos procedentes de un 
origen de datos y mostrar los datos y los resultados al usuario. Esto, como hemos 
podido comprobar, supone un trabajo importante en el desarrollo de una aplica- 
ción. Pero una aplicación puede también solicitar datos al usuario, lo que requeri- 
rá analizar, aceptar o rechazar tales datos, simplemente porque los usuarios 
cometen errores tipográficos, olvidan especificar los valores necesarios, escriben 
valores en el sitio equivocado, eliminan o agregan registros que no deberían y, por 
lo general, cumplen la ley de Murphy siempre que pueden: “Si algo puede salir 
mal, saldrá mal”. Evitar estas entradas erróneas o malintencionadas es otra parte 
importante en el desarrollo de una aplicación. ¿Cómo? Implementando reglas de 
validación para cada caso que se pueda presentar. 
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En este mismo capítulo ya hemos visto algunos ejemplos relacionados con la 
validación y la conversión de datos, concretamente en el apartado Crear un enla- 
ce. Allí vimos que la clase Binding cuenta con los eventos Format y Parse, que 
se pueden utilizar para aplicar conversiones antes de mostrar los datos en el des- 
tino o antes de almacenarlos en el origen, respectivamente, y expusimos un ejem- 
plo que mostraba un diálogo, vinculado con un objeto de negocio, que solicitaba 
datos al usuario que eran validados antes de ser almacenados en el origen y for- 
mateados antes de ser mostrados en el destino. 


Ahora vamos a ver cómo controlar los errores que se puedan producir durante 
la entrada de datos en el control DataGridView de Windows Forms y cómo vali- 
dar esos datos. 


En base al ejemplo que estamos desarrollando, a la hora de solicitar datos al 
usuario podríamos optar por añadir una nueva ventana de diálogo para solicitar 
esos datos (por ejemplo, porque las celdas de la rejilla no fueran editables) y una 
vez validados almacenarlos en el origen, o bien, si las celdas son editables, intro- 
ducir los datos directamente a través de la rejilla validándolos y controlando posi- 
bles errores. 
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Como ejemplo, vamos a continuar desarrollando nuestra aplicación (lo hare- 
mos sobre un nuevo proyecto ControlDeErrores idéntico al anterior, excepto en 
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que la columna ZD de la primera rejilla ahora será editable) con el fin de validar la 
entrada de datos en las celdas correspondientes a la columna /D, para que el iden- 
tificador sea único; Nombre y Dirección, para que no queden vacías; Estudios, es- 
te dato será elegido de una lista evitando así toda posibilidad de error, por lo tanto, 
definiremos esta columna de solo lectura (propiedad ReadOnly); y Beca, este da- 
to está perfectamente definido por medio del control casilla de verificación. 


Error en los datos 


El control DataGridView facilita el control de errores en los datos del origen de 
datos subyacente exponiendo el evento DataError, que se produce cuando el ori- 
gen de datos detecta una infracción debida a una restricción o regla empresarial; 
por ejemplo, se producirá el evento si el usuario de la aplicación introduce en una 
nueva fila o en una fila existente un valor en la columna /dAlumno duplicado, que 
podemos controlar para mostrar al usuario un mensaje acerca del error cometido. 
Añada, por lo tanto, este controlador, y edítelo como se indica a continuación: 


private void listAlumnosDataGridView_DataError(object sender, 
DataGridViewDataErrorEventArgs e) 

( 
if (e.Exception != null 24 

e.Context == DataGridViewDataErrorContexts.Commit) 


( 





switch (listAlumnosDataGridView.Columns[e.ColumnIndex].HeaderText) 
( 
case "ID": 
MessageBox.Show(e.Exception.Message); 
break; 


Este método comprueba si se lanzó una excepción al enviar los datos de la 
celda ZD al origen de datos para escribirlos. Si esto sucede, entonces notifica al 
usuario acerca del error ocurrido. Para ello, es necesario que el origen de datos sea 
capaz de detectar tal anomalía y lanzar la excepción correspondiente (algo impli- 
cito, por ejemplo, en bases de datos), por lo que tendremos que modificar la pro- 
piedad /dAlumno de la clase Alumno como se indica a continuación: 


public int IdAlumno 
( 
get { return _idAlumno; } 
set 
( 
if (bbdd.ObtenerAlumnoPorldí(value) != null) 
throw new Exception("IdAlumno duplicado"); 
_idAlumno = value; 
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OnPropertyChanged(new PropertyChangedEventArgs("IdAlumno")); 
) 
) 


La propiedad IdAlumno de la clase Alumno se ha modificado para, invocando 
al método ObtenerAlumnoPorld de nuestro modelo de objetos, verificar si el iden- 
tificador que se quiere establecer ya existe en la base de datos. 


Validación 


La clase DataGridView proporciona una manera cómoda de realizar la valida- 
ción antes de que los datos se confirmen en el origen de datos subyacente a través 
de los eventos CellValidating y CellValidated; el primero se produce cuando 
cambia el contenido de la celda actual del DataGridView y se inicia la valida- 
ción; y el segundo, cuando finaliza la validación. 


Por ejemplo, cuando el usuario edita una celda de la columna Nombre e inten- 
ta abandonar la misma, el controlador del evento CellValidating puede examinar 
la cadena del nuevo nombre y asegurarse de que su contenido está formado por 
una o más letras y espacios; si el nuevo valor es una cadena vacía o incumple la 
regla, el DataGridView impedirá que el cursor del usuario abandone la celda has- 
ta que no se especifique una cadena que se ajuste a lo establecido. Análogamente 
procederemos cuando el usuario edite una celda de la columna Dirección; en este 
caso, el DataGridView impedirá que el cursor del usuario abandone la celda 
mientras la celda esté vacía o su contenido no se corresponda con una cadena al- 
fanumérica que empiece con un carácter que no sea el espacio en blanco. Según 
esto, añada el controlador del evento CellValidating y edítelo como se muestra a 
continuación: 


private void listAlumnosDataGridView_CellValidating(object sender, 
DataGridViewCellValidatingEventArgs e) 
( 
Regex ex_reg; 
switch (listAlumnosDataGridView.Columnms[e.ColumniIndex].HeaderText) 
( 
case "Nombre": 
// Expresión regular: una o más letras/espacios 
ex_reg = new Regex("^([a-zA-ZňÑŇÑáÁéÉíÍĆÓQGÚJ\\s*)+$"); 
if (lex_reg.IsMatch(e.FormattedValue.ToString())) 
( 
listAlumnosDataGridView.Rows[le.RowIndex].ErrorText = 
"El nombre tiene que tener una o más letras/espacios"; 
e.Cancel = true; 





) 
break; 
case "Dirección": 
// Expresión regular: uno o más caracteres alfanuméricos 
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ex_reg = new Regex("^(\\w\\s*)+$"); 
if (lex_reg.IsMatch(e.FormattedValue.ToString())) 
( 
listAlumnosDataGridView.Rows[le.RowIndex].ErrorText = 
"La dirección no puede estar vacía"; 
e.Cancel = true; 
) 
break; 


Este método, tanto para la columna Nombre como para Dirección, verifica si 
la cadena introducida cumple los requisitos solicitados en cada caso; de no cum- 
plirse, se cancela el evento lo que implica cancelar los cambios en la celda actual 
permaneciendo el cursor en la misma hasta que la entrada sea válida, al mismo 
tiempo que se muestra un icono de error en el encabezado de la fila para que 
cuando el usuario ponga el puntero del ratón sobre el mismo, se muestre el mensa- 
je de error que indica lo ocurrido. 


r 
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Cuando el usuario recibe la notificación de que la entrada de datos que está 
realizando sobre una celda de la fila actual es errónea y la corrige resultando la 
validación satisfactoria, el icono de error permanece, por lo que habrá que quitar- 
lo; esto se hace asignando a la propiedad ErrorText de esa fila una cadena vacía. 
Esto se puede hacer controlando el evento CellValidated, que se produce después 
de que finaliza la validación, o bien controlando el evento CellEndEdit que se 
produce cuando finaliza el modo de edición de la celda seleccionada. Según esto, 
añada el controlador de este evento y edítelo así: 


private void listAlummosDataGridView_CellEndEdit(object sender, 
DataGridViewCellEventArgs e) 
( 

listAlumnosDataGridView.Rows[e.RowIndex].ErrorText = String.Empty; 
) 
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Datos que no necesitan validación 


Cuando los datos de una celda pertenecen a un conjunto específico de valores (por 
ejemplo, los meses del año), dichos valores pueden ser proporcionados a través de 
una lista desplegable o desde otro control análogo. 


Por ejemplo, una celda de la columna Estudios tendrá un conjunto de valores 
especificos (los estudios ofertados por la entidad correspondiente). Entonces, para 
evitar errores durante la entrada de datos, vamos a proporcionar estos valores por 
medio de los elementos de un menú contextual que se mostrará cuando el usuario 
haga clic con el botón secundario del ratón sobre dicha columna. Parece lógico 
entonces que esta columna sea de solo lectura. 
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Según lo expuesto, añada un control ContextMenuStrip al formulario. Des- 
pués, edite las columnas del DataGridView y asocie la columna Estudios con es- 
te menú contextual, contextMenuEstudios, según muestra la figura siguiente: 
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Columnas seleccionadas: Propiedades de columnas enlazadas 

æl 1D | ESATE 

abl Nombre | Visible True A 

ebl Dirección | 4 Comportamiento 

gl Estudios | (ninguno) ma 

Beca MaxInputLength (ninguno) | | 
ReadOnly contextMenuEstudios | 
Resizable rue | : | 





Este menú contextual será poblado desde los datos de la base de datos por 
medio de una propiedad ObtenerEstudios que añadiremos a la clase bbdd, que de- 
vuelve una matriz con los elementos, de tipo ToolStripMenultem, del menú. 


public static ToolStripMenultem[] ObtenerEstudios 
( 
fd 


1 
$ 


La propiedad Text de estos elementos será la cadena correspondiente a la de- 
nominación de los estudios. 


Entonces, para poblar el menú contextual con los elementos correspondientes, 
tiene que añadir la siguiente línea de código al constructor del formulario: 


public Form1() 

( 
InitializeComponent(); 
vista = new BindingListView<Alumno>(bbdd.Alumnos); 
listAlumosBindingSource.DataSource = vista; 
MostrarPosicion(); 
contextMenuEstudios.Items.AddRange(bbdd.ObtenerEstudios); 


Ahora, cuando el usuario quiera cambiar una celda de la columna Estudios, 
seleccionará la fila correspondiente, hará clic con el botón secundario del ratón 
sobre dicha columna y seleccionará el elemento correspondiente a los estudios 
deseados, acción que producirá el evento ItemClicked del menú contextual (se 
produce cuando se hace clic). Lo que esperamos es que el contenido actual de la 
celda sea reemplazado con el texto del elemento seleccionado. Por lo tanto, añada 
el controlador de este evento y edítelo como se indica a continuación: 


private void contextMenuEstudios_ItemClicked(object sender, 
ToolStripltemClickedEventArgs e) 
( 
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ObjectView<Alumno> obVista = 
listAlumnosBindingSource.Current as ObjectView<Alumno>; 
obVista.Object.EstAlumno = e.Clickedltem. Text; 
) 


Observe que este método modifica realmente el elemento actual del origen de 
datos subyacente. El enlace a datos hará el resto: actualizar la rejilla. 


Con las otras dos rejillas (la segunda, la que muestra los tipos de asignaturas, 
y la tercera, la que muestra las asignaturas) seguiremos un procedimiento análogo 
al realizado sobre esta primera. En ambas rejillas vamos a establecer sus columnas 
de solo lectura, para que sus valores solo puedan ser establecidos desde un con- 
junto de valores específicos. 


Según lo expuesto, añada otro control ContextMenuStrip al formulario. 
Después, edite las columnas de la segunda rejilla y asocie la columna Tipo con es- 
te menú contextual, contextMenuTiposAsigs, el cual será poblado desde los datos 
de la base de datos bbdd por medio de otra propiedad ObtenerTiposAsigs que 
añadiremos a la clase bbdd, que devuelve una matriz con los elementos, de tipo 
ToolStripMenultem, de dicho menú. 


public static ToolStripMenultem[] ObtenerTiposAsigs 
( 

// 
) 


La propiedad Text de los elementos de esta matriz será la cadena correspon- 
diente a la denominación de los tipos de asignaturas. Entonces, para poblar el me- 
nú contextual contextMenuTiposAsigs con los elementos de esta matriz, añada la 
siguiente línea de código al constructor del formulario: 


public Forml() 

( 
InitializeComponent(); 
vista = new BindingListView<Alumno>(bbdd.Alumnos); 
listAlumosBindingSource.DataSource = vista; 
MostrarPosicion(); 
contextMenuEstudios.Items.AddRange(bbdd.ObtenerEstudios); 
contextMenuTiposAsigs.Items.AddRange(bbdd.ObtenerTiposAsigs):; 


Ahora, cuando el usuario quiera cambiar una celda de la columna Tipo, selec- 
cionará la fila correspondiente, hará clic con el botón secundario del ratón sobre 
dicha columna y seleccionará el elemento correspondiente al tipo de estudios 
deseado, acción que producirá el evento ItemClicked del menú contextual que 
controlaremos para reemplazar el contenido actual de la celda con el texto del 
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elemento seleccionado. Por lo tanto, añada este controlador y edítelo como se in- 
dica a continuación: 


private void contextMenuTiposAsigs_ItemClicked(object sender, 
ToolStripltemClickedEventArgs e) 
( 
Asignaturas obj = 
listaloAsignaturasBindingSource.Current as Asignaturas; 
// Modificar el tipo de asignaturas 
obj.Tipo = e.Clickedltem.Text; 
) 


Y, ¿cómo haremos para añadir una nueva fila en esta rejilla donde sus colum- 
nas son de solo lectura? (piense en un alumno que actualmente solo está matricu- 
lado de asignaturas obligatorias, por ejemplo). Pues vamos a programar esta 
operación para que se pueda realizar haciendo doble clic sobre cualquier celda vá- 
lida de la rejilla, acción que generará el evento CellDoubleClick. Por lo tanto, 
añada este controlador y edítelo para que invoque al método AddNew del Bin- 
dingSource correspondiente: 


private void listaloAsignaturasDataGridView_CellDoubleClick( 
object sender, DataGridViewCellEventArgs e) 
( 
// Si es la fila siguiente a la última válida 
if (e.RowIndex == listaloAsignaturasDataGridView.Rows.Count - 1) 


( 





MessageBox.Show("Haga clic sobre una fila existente"); 
return; 
) 
// Añadir una fila nueva; pasa a ser la actual. 
listaloAsignaturasBindingSource.AddNew(); 
Asignaturas obj = 
listaloAsignaturasBindingSource.Current as Asignaturas; 
obj.Tipo = "Clic con el botón secundario para elegir un tipo"; 


La primera parte de este método garantiza que no tenga lugar ninguna acción 
cuando el usuario haga clic en la fila siguiente a la última con datos de la rejilla, 
ya que esta acción intentaría crear una nueva fila (piense qué sucedería si esas 
celdas no fueran de solo lectura: se iniciaría su edición y se añadiría una nueva fi- 
la), de forma que al ejecutarse AddNew se lanzaría una excepción debido a una 
operación no válida dado el estado actual del objeto sin finalizar, problema que no 
existe si se hace doble clic sobre una celda válida. La segunda parte invoca al mé- 
todo AddNew que agrega un nuevo elemento a la lista subyacente representada 
por la propiedad de List del BindingSource y el enlace hace el resto: añadir una 
nueva fila a la rejilla. Este método genera un evento AddingNew que si no se 
controla (por ejemplo, para construir el nuevo elemento), como sucede en nuestro 
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caso, y la lista subyacente es IBindingList, la solicitud de añadir un nuevo ele- 
mento se pasa automáticamente al método de AddNew de IBindingList. 


El siguiente paso es permitir, para el tipo de asignaturas seleccionado, modifi- 
car alguna fila en la tercera rejilla o añadir nuevas asignaturas al grupo ya existen- 
te. Como ya habrá pensado, el proceso es análogo al desarrollado para la segunda 
rejilla. Añada, por lo tanto, otro control ContextMenuStrip al formulario. Des- 
pués, edite las columnas de la tercera rejilla y asocie sus columnas, ZD y Nombre, 
con este menú contextual, contextMenuAsigs, el cual será poblado desde los datos 
de la base de datos por medio de otras dos propiedades que añadiremos a la clase 
bbdd: ObtenerAsigsOB, para las asignaturas obligatorias, y ObtenerAsigsOP, para 
las optativas; ambas propiedades devuelven una matriz con los elementos, de tipo 
ToolStripMenultem, de dicho menú. 


public static ToolStripMenultem[] ObtenerAsigs0B 
( 

fd 
} 


public static ToolStripMenuItem[] ObtenerAsigsOP 
( 

// 
) 


La propiedad Text de los elementos de estas matrices será la cadena corres- 
pondiente al nombre de la asignatura y su propiedad Tag almacenará el identifi- 
cador de la misma. 


Lo anteriormente expuesto nos conduce a pensar que el contenido del menú 
contextual contextMenuAsigs será función del tipo de asignaturas seleccionado en 
la segunda rejilla. Por lo tanto, este contenido lo tendremos que establecer diná- 
micamente, por ejemplo, cuando la celda del tipo de asignatura a seleccionar reci- 
ba el foco. Según esto, añada el controlador del evento CellEnter de esta rejilla y 
edítelo así: 


private void listaCoAsignaturasDataGridView_CellEnter( 
object sender, DataGridViewCellEventArgs e) 
( 
string tipo = 
listaloAsignaturasDataGridView.CurrentCell.Value.ToString(); 
contextMenuAsigs.Items.Clear(); 
switch (tipo) 
{ 
case "Obligatorias": 
contextMenuAsigs.Items.AddRange(bbdd.ObtenerAsigs0B); 
break; 
case "Optativas": 
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contextMenuAsigs.Items.AddRange(bbdd.ObtenerAsigsO0P); 
break; 


Ahora, cuando el usuario quiera cambiar una asignatura, seleccionará la fila 
correspondiente, hará clic con el botón secundario del ratón sobre dicha columna 
y seleccionará el elemento correspondiente a la asignatura deseada, acción que 
producirá el evento ItemClicked del menú contextual que controlaremos para es- 
tablecer los nuevos datos como se indica a continuación: 


private void contextMenuAsigs_ItemClicked(object sender, 

ToolStripltemClickedEventArgs e) 

( 
Asignatura obj = 

listaAsignaturasBindingSource.Current as Asignatura; 

// Modificar id y nombre de la asignatura 
obj.IdAsignatura = (int)e.ClickedItem.Tag; 
obj.NomAsignatura = e.Clickedltem.Text; 





Y para añadir una nueva fila en esta rejilla (recuerde que sus columnas son de 
solo lectura) procederemos igual que hicimos para la segunda rejilla. Por lo tanto, 
añada el controlador del evento CellDoubleClick de esta rejilla y edítelo para que 
invoque al método AddNew del BindingSource correspondiente: 


private void listaAsigsDataGridView_CellDoubleClick(object sender, 
DataGridViewCellEventArgs e) 
( 
// Si es la fila siguiente a la última válida 
if (e.Rowlndex == listaAsigsDataGridView.Rows.Count - 1) 


( 





MessageBox.Show("Haga clic sobre una fila existente"); 

return; 
) 
// Añadir una fila nueva; pasa a ser la actual. 
listaAsignaturasBindingSource.AddNew(); 
Asignatura obj = 

listaAsignaturasBindingSource.Current as Asignatura; 
obj.NomAsignatura = 

"Clic con el botón secundario para elegir una asignatura"; 





Evitar que un alumno se matricule dos veces de una misma asignatura es una 
tarea sencilla si recuerda que la clase Alumno tiene un método ObtenerAsignatura 
que devuelve el objeto Asignatura, de las asignaturas de las que está matriculado 
el alumno, que tenga por identificador el pasado como argumento, o null si el 
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alumno no está matriculado de esa asignatura. Según esto, modifique el método 
contextMenuAsigs ItemClicked como se indica a continuación: 


private void contextMenuAsigs_ItemClicked(object sender, 


ToolStripltemClickedEventArgs e) 


( 


// Verificar si el alumno ya está matriculado de esta asignatura 

ObjectView<Alumno> obVista = 
listAlumnosBindingSource.Current as ObjectView<Alumno>; 

if (obVista.Object.ObtenerAsignatura((int)e.ClickedItem.Tag) != null) 

í 








MessageBox.Show("IdAsignatura duplicado"); 

PSEmras 
) 
Asignatura obj = 

listaAsignaturasBindingSource.Current as Asignatura; 
// Modificar id y nombre de la asignatura 
obj.IdAsignatura = (int)e.ClickedItem.Tag; 
obj.NomAsignatura = e.Clickedltem.Text; 


Dejamos como trabajo para el lector evitar que la segunda lista presente dos 


tipos de asignaturas iguales. 


CAPÍTULO 13 


O F.J.Ceballos/RA-MA 


ACCESO A UNA BASE DE DATOS 


Una base de datos es una colección de datos y un conjunto de programas para ac- 
ceder a los mismos. Los datos están clasificados y estructurados y son guardados 
en uno o varios ficheros pero referenciados como si de un único fichero se tratara. 
Para crear y manipular bases de datos relacionales, objetivo de este capítulo, exis- 
ten en el mercado varios sistemas administradores de bases de datos; por ejemplo, 
SOL Server, Access, Oracle y DB2. Otros sistemas administradores de bases de 
datos de interés y de libre distribución son PostgreSOL y MySOL. 


Los datos de una base de datos relacional se almacenan en tablas lógicamente 
relacionadas entre sí utilizando campos clave comunes. A su vez, cada tabla dis- 
pone los datos en filas y columnas. Por ejemplo, piense en el listín de teléfonos. 
Los datos relativos a un teléfono (nombre, dirección, teléfono, etc.) son columnas 
que agrupamos en una fila. El conjunto de todas las filas de todos los teléfonos 
forma una tabla de la base de datos. 











Nombre Dirección Teléfono 
Aguado Rodríguez, Jesús Las Ramblas 3, Barcelona | 932345678 
Cuesta Suñer, Ana María Mayor 22, Madrid 918765432 




















Como se puede observar, una tabla es una colección de datos presentada en 
forma de una matriz bidimensional, donde las filas reciben también el nombre de 
tuplas o registros, y las columnas, de campos. 


Los usuarios de un sistema administrador de bases de datos pueden realizar 
sobre una determinada base operaciones como insertar, recuperar, modificar y 
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eliminar datos, así como añadir nuevas tablas o eliminarlas. Estas operaciones se 
expresan generalmente en un lenguaje denominado SQL. 


SQL 


SQL es el lenguaje estándar para interactuar con bases de datos relacionales y es 
soportado prácticamente por todos los sistemas administradores de bases de datos 
actuales. En él, las unidades básicas son tablas, columnas y filas. La tabla propor- 
ciona una forma simple de relacionar los datos que componen la misma, una co- 
lumna representa un dato presente en la tabla, mientras que una fila representa un 
registro o entrada de la tabla. 


Este apartado introducirá al lector que no conoce SQL en las operaciones más 
comunes que este lenguaje proporciona para acceso a bases de datos. SQL incluye 
operaciones tanto de definición, por ejemplo CREATE, como de manipulación de 
datos, por ejemplo INSERT, UPDATE, DELETE y SELECT. 


Crear una base de datos 


Para crear una base de datos, SQL proporciona la sentencia CREATE DATABA- 
SE, cuya sintaxis es: 


CREATE DATABASE <base de datos> 


Esta sentencia especifica el nombre de la base de datos que se desea crear. 
Cuando desee eliminarla, ejecute la sentencia: 


DROP DATABASE <base de datos> 


Crear una tabla 


Para crear una tabla, SQL proporciona la sentencia CREATE TABLE. Esta sen- 
tencia especifica el nombre de la tabla, los nombres y tipos de las columnas de la 
tabla y las claves primaria y ajena de esa tabla (también llamada extranjera, en el 
sentido de que es importada de otra tabla). Su sintaxis es la siguiente: 


CREATE TABLE <tabla>(<columna 1> [,<columna 2>]...) 


donde columna n se formula según la sintaxis siguiente: 


<columna n> <tipo de dato> [DEFAULT <expresión>] 
[<constante 1> [<constante 2>]...] 
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Algunos de los tipos de datos más utilizados son los siguientes: 



































Tipo SOL Tipo SOL de .NET Framework Tipo MS Access 
INTEGER SqlInt32 Número entero largo 
REAL SqlSingle Número simple 
FLOAT SqlDouble Número doble 
CHAR SqlString Texto 

VARCHAR SqlString Texto 

BINARY SqlBinary Binario 

DATE SqlDateTime Fecha/Hora 








La cláusula DEFAULT permite especificar un valor por omisión para la co- 
lumna y, opcionalmente, para indicar la forma o característica de cada columna, 
se pueden utilizar las constantes NOT NULL (no se permiten valores nulos: 
NULL), UNIQUE o PRIMARY KEY. 


La cláusula PRIMARY KEY se utiliza para definir la columna como clave 
principal de la tabla. Esto supone que la columna no puede contener valores nulos 
ni duplicados; es decir, que dos filas no pueden tener el mismo valor en esa co- 
lumna. Una tabla puede contener una sola restricción PRIMARY KEY. 


La cláusula UNIQUE indica que la columna no permite valores duplicados; es 
decir, que dos filas no pueden tener el mismo valor en esa columna. Una tabla 
puede contener varias restricciones UNIQUE. Se suele emplear para que el propio 
sistema compruebe que no se añaden valores que ya existen. 


El ejemplo que se muestra a continuación crea la tabla telefonos, en la base de 
datos con la que estemos trabajando, con las columnas nombre, direccion, tele- 
fono y observaciones de los tipos especificados. La columna telefono es la clave 
principal; esto implica que en esa columna todos los valores tienen que ser dife- 
rentes y no nulos. El resto de las columnas, excepto observaciones, tampoco per- 
mite valores nulos: 


CREATE TABLE telefonos( 





nombre VARCHAR(30) NOT NULL, 
direccion VARCHAR(30) NOT NULL, 
telefono VARCHAR(12) PRIMARY KEY NOT NULL, 


observaciones VARCHAR(240) 


La diferencia entre los tipos CHAR (n) y VARCHAR (n) es que en el primer 
caso, el campo se rellena con espacios hasta n caracteres (longitud fija) y en el se- 
gundo no (longitud variable). 
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Escribir datos en la tabla 


Para escribir datos en una tabla, SQL proporciona la sentencia INSERT. Esta sen- 
tencia agrega una o más filas nuevas a una tabla. Su sintaxis, de forma simplifica- 
da, es la siguiente: 





INSERT [INTO] <tabla> [(<columna 1>[,<columnma 2>]...)] 
VALUES (<expresión 1>[,<expresión 2>]...),... 











INSERT [INTO] ... SELECT ... FROM... 


donde tabla es el nombre de la tabla en la que se desea insertar las filas, argumen- 
to que va seguido por una lista con los nombres de las columnas que van a recibir 
los datos especificados por la lista de valores que siguen a la cláusula VALUES. 
Las columnas no especificadas en la lista reciben el valor NULL, si lo permiten, o 
el valor predeterminado, si se especificó. Si todas las columnas reciben datos, se 
puede omitir la lista con los nombres de las columnas. 


Con respecto al segundo formato, un poco más adelante veremos la sentencia 
SELECT. 


El ejemplo que se muestra a continuación añade a la tabla telefonos una nueva 
fila con los valores de las columnas especificados: 


INSERT INTO telefonos 
VALUES (*Leticia Aguirre Soriano’, Madrid’, 
912345671” ,”Ninguna” ) 


Modificar datos de una tabla 


Para modificar datos en una tabla, SQL proporciona la sentencia UPDATE. Esta 
sentencia puede cambiar los valores de filas individuales, grupos de filas o todas 
las filas de una tabla. Su sintaxis es la siguiente: 


UPDATE <tabla> 
SET <columna 1 = (<expresión 1> | NULL) 
[, <columna 2 = (<expresión 2> | NULL)]... 
WHERE <condición de búsqueda> 


La cláusula SET contiene una lista separada por comas de las columnas que 
deben actualizarse y el nuevo valor de cada columna. El valor suministrado por 
las expresiones incluye elementos tales como constantes, valores seleccionados de 
una columna de otra tabla, o valores calculados por una expresión compleja. Y la 


CAPÍTULO 13: ACCESO A UNA BASE DE DATOS 497 


cláusula WHERE especifica la condición de búsqueda que define la fila de la ta- 
bla cuyas columnas se desea modificar. 


El ejemplo que se muestra a continuación modifica en la tabla telefonos la di- 
rección de la persona cuyo teléfono se especifica: 


UPDATE telefonos 
SET direccion=*Triana, Sevilla” 
WHERE telefono=*91234567” 


Borrar registros de una tabla 


Para borrar registros en una tabla, SQL proporciona la sentencia DELETE. Esta 
sentencia quita una o varias filas de una tabla. Una forma simplificada de la sinta- 
xis de DELETE es: 


DELETE FROM <tabla> WHERE <condición de búsqueda» 


El argumento tabla nombra la tabla de la que se van a eliminar las filas. Se 
eliminan todas las filas que reúnan los requisitos de la condición de búsqueda de 
la cláusula WHERE. Si no se especifica una cláusula WHERE, se eliminan todas 
las filas de la tabla. 


Cualquier tabla de la que se hayan quitado todas las filas sigue permanecien- 
do en la base de datos. La instrucción DELETE solo elimina filas de la tabla; si se 
quiere quitar la tabla de la base de datos, hay que ejecutar la sentencia: 


DROP TABLE <tabla> 


El ejemplo que se muestra a continuación quita de la tabla telefonos el alumno 
que tiene la clave especificada: 


DELETE FROM telefonos WHERE telefono=*958324555” 


Seleccionar datos de una tabla 


Para seleccionar datos de una tabla, SQL proporciona la sentencia SELECT. Las 
cláusulas principales de esta sentencia se pueden resumir del modo siguiente: 


SELECT [ALL | DISTINCT] <lista de selección> 
FROM <tablas> 
WHERE <condiciones de selección> 
[ORDER BY <columna 1> [ASC|DESCI[, <columma 2> [ASC|DESCI]...] 
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Las cláusulas de una instrucción SELECT deben especificarse en el orden in- 
dicado. 


El argumento lista de selección describe las columnas del conjunto de resul- 
tados que se desea obtener. Es una lista de expresiones separadas por comas. Cada 
expresión de lista de selección suele ser una referencia a una columna de la tabla 
de la que provienen los datos, aunque puede ser cualquier otra expresión. Al usar 
la expresión * en una lista de selección se especifica que se devolverán todas las 
columnas de la tabla de origen. 


La cláusula DISTINCT elimina las repeticiones del conjunto de resultados ob- 
tenido por SELECT, y ALL especifica que pueden aparecer filas duplicadas en el 
conjunto de resultados; es el valor predeterminado. 


La cláusula FROM especifica una lista de las tablas de donde se recuperan los 
datos del conjunto de resultados. 


La cláusula WHERE describe un filtro que define las condiciones que debe 
cumplir cada fila de las tablas de origen para satisfacer los requisitos de la ins- 
trucción SELECT. Sólo las filas que cumplen las condiciones contribuyen con 
datos al conjunto de resultados. Los datos de las filas que no cumplen las condi- 
ciones no se usan. 


La cláusula ORDER BY define el orden de las filas del conjunto de resultados 
y especifica las columnas que intervienen en la clasificación. Las palabras clave 
ASC y DESC se utilizan para especificar si las filas se ordenan en una secuencia 
ascendente o descendente. Por omisión se supone ASC, 


El ejemplo siguiente lista todas las filas de la tabla telefonos: 


SELECT * FROM telefonos 


Este otro ejemplo lista todas las filas de la tabla telefonos ordenadas ascen- 
dentemente por el campo nombre: 


SELECT * FROM telefonos ORDER BY nombre 


SQL permite utilizar los operadores <, <=, >, >=, <>, AND, OR, NOT, IS 
NULL, LIKE, BETWEEN, IN, ALL, ANY, etc. El ejemplo siguiente lista los re- 
gistros de la tabla telefonos cuyo teléfono sea mayor que 958000000: 





SELECT * FROM telefonos WHERE telefono>”958000000” 
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El siguiente ejemplo lista todos los registros de la tabla telefonos que empie- 
cen por 91 (91* o 91%): 


SELECT * FROM telefonos WHERE telefono LIKE *91*” 


Crear una base de datos 


Dependiendo del sistema administrador de bases de datos que tenga, Access, SOL 
Server, Oracle, DB2, MySQL, PostgreSQL, etc., la operación de crear una base de 
datos puede variar cuando se realiza desde el entorno de desarrollo aportado por 
ese sistema, pero no variaría si la creáramos desde la línea de órdenes utilizando 
el lenguaje SQL, operación que no es muy común (véase en el apéndice A Conec- 
tar a LocalDB o a SOLExpress). 


Base de datos Microsoft Access 


Por ejemplo, vamos a crear una base de datos con Microsoft Access. Desde este 
entorno de desarrollo, esta operación resulta muy sencilla. Simplemente hay que: 


e Abrir Microsoft Access. 


e Ejecutar la orden Nuevo del menú Archivo. Seleccionar Base de datos en 
blanco. 


e Introducir el nombre de la base de datos. En nuestro caso, bd_telefonos.accdb. 
Pulsar el botón Crear. Se abre la nueva base de datos, se crea una nueva tabla 
denominada Tablal y se abre en la vista Hoja de datos. Cuando necesite crear 
una nueva tabla: Crear > Tablas. 


e Cambie a la vista de diseño para editar los campos de la tabla: Ver > Vista de 
diseño y asigne un nombre a la tabla; en nuestro caso, telefonos. 


e Introducir el nombre, el tipo y las propiedades para cada uno de los campos 
de un registro. En nuestro caso: 


Campo Tipo Descripción 

nombre Texto de 30 caracteres Nombre y apellidos 
direccion Texto de 30 caracteres Dirección de la persona 
telefono Texto de 12 caracteres Número de teléfono 
observaciones Texto de 240 caracteres Observaciones 


e Requerir los tres primeros campos (propiedad Requerido = sí). 


e Para el campo telefono establecer la propiedad Indexado al valor sí (sin dupli- 
cados). 


e Definir telefono como clave principal (clic con el botón secundario del ratón y 
seleccionar Clave principal). 
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e Guarde el diseño y cambie a la vista de datos (Ver > Vista de datos) para in- 
troducir los datos. 


Data Merram base de dato! Diseño 
ol 
a insertar filas y a 
Y UA Ip Y 3 3 


Probar reglas Hoja de idies Crear macros Cambre Relavones Dependenass 
de validación SA Modificar bitquedas roniedades de dos > nombre/iliminar Macro del objeto 


Herranwentas Eventos de campo. registre y tabla Relaciones 
> ===; 








Un nombre de campo puede tener hasta 64 
caracteres de longitud incluyendo espacios. 
Presione Fl para obtener ayuda acerca de los 
nombres de campo. 











Vista Diseño, FS = Cambiar paneles, Fl = Ayuda. Bloq Num | 3 8 ad 


Una vez creada la base de datos, puede ejecutar manualmente cualquier sen- 
tencia SQL sobre la misma. Para ello, haga clic en Crear > Diseño de consulta, 
agregue la tabla, seleccione el campo y, por ejemplo, fije los criterios. Finalmente, 
haga clic en Ejecutar (esquina superior izquierda). En la figura siguiente puede 
observarse la vista de diseño de consultas; si lo prefiere, puede cambiar a la vista 
SQL haciendo clic en el botón SQL situado en la esquina inferior derecha: 


Herramientas de consultas 


Diseño 


Ta iesertar fas Y insertar columnas mn 
(EE) ' "E e F mna Mas W pliminar columnas z 3 


Ver Ejecutar Crear Anexar Mostrar Totales 
a tabla H Eliminar w2 Definición de datos tabia S Generador SM Devuelve: Todo - 


Resultados Too de consulta Corbuga acan de corauñas Mostrar u ocultar 
Todos los objetos...) « | amtetonas 
ll acor 
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Base de datos Microsoft SQL Server 


En este apartado, vamos a crear una base de datos con Microsoft SOL Server. Este 
proceso resulta muy sencillo si tiene instalado el administrador corporativo que 
incorpora el paquete de SQL Server (en su versión empresarial), pero si solo tiene 
instalado SQL Server Express, puede instalar cualquier otro administrador de ca- 
racterísticas análogas, como Microsoft SOL Server Management Studio Express 
(véase el apéndice A). O también, como se explica en el apartado Maestro-detalle 
un poco más adelante en este mismo capítulo, otra forma de crear bases de datos 
es a través del explorador de bases de datos del EDI de Visual Studio. También, 
aunque solo tenga instalado SQL Server Express, dispondrá de la utilidad 
SQLCMD ejecutable desde la línea de órdenes. Como ejemplo, utilizando 
SQLCMD, vamos a crear la misma base de datos que creamos en el apartado ante- 
rior con Access (en este caso la vamos a denominar bd" telefonos). Para ello, siga 
los pasos indicados a continuación: 


e Ejecute la orden Inicio > Ejecutar > cmd para abrir el intérprete de órdenes 
(consola del sistema). 


e Localice en su instalación el fichero SOLCMD.EXE, cambie a ese directorio 
y ejecute la orden: 


SQLCMD -S nombre-del-ordenadorYSqlExpress 


Microsoft Windows [Versión 6.1.7601] 
Copyright (c) 2009 Microsoft Corporation. Reservados todos los derechos. 


C:Usersifjceballos>cd C:\Program Files\Microsoft SQL Server\100\Tools\Binn 











e Ejecute el guión indicado en la figura siguiente. En la carpeta Cap13 localiza- 
da en el CD que acompaña al libro, tiene el fichero generador bd telefo- 
nos.sql que le proporcionará dicho guión; para mayor sencillez, cópielo y 
péguelo en la línea de órdenes. 
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CREATE DATABASE bd_telefonos 
GO 


USE bd_telefonos 
GO 
cambió el contexto de la base de datos a 'bd_telefonos'. 


CREATE TABLE telefonos 
( 
nombre VARCHAR(30) NOT NULL, 
direccion VARCHAR(30) NOT NULL, 
telefono VARCHAR( 12) PRIMARY KEY NOT NULL, 
observaciones UARCHAR( 240) 


GO 


INSERT INTO telefonos 
VALUES ('Leticia Aguirre Soriano', 'Triana, Sevilla', '954345678', "Ni 


4> INSERT INTO telefonos 

5> VALUES ('Pedro Aguado Rodríguez', 'Alcalá de Henares, Madrid', *'918888 
888", 'Ninguna') 

G> INSERT INTO telefonos 











La base de datos bd_telefonos está creada; tiene una tabla denominada telefo- 
nos. Si tiene instalada la utilidad Microsoft SOL Server Management Studio Ex- 
press a la que nos hemos referido anteriormente, podrá utilizarla para operar sobre 
la base de datos, o bien, a falta de esta herramienta con interfaz gráfica, puede se- 
guir utilizando SOLCMD. Finalmente, sepa que el fichero bd_telefonos.mdf está 
localizado en la carpeta Data de la instalación de Microsoft SQL Server, aunque 
este dato no es necesario. 


ADO.NET 


Muchas de las aplicaciones, distribuidas o no, trabajan sobre bases de datos. Por 
esta razón, Microsoft decidió crear una tecnología de acceso a datos potente y fá- 
cil de utilizar: ADO.NET. 


e ADO.NET no depende de conexiones continuamente activas, esto es, se dise- 
ñó en torno a una arquitectura donde las aplicaciones se conectan a la base de 
datos solo durante el tiempo necesario para extraer o actualizar los datos. De 
esta forma, la base de datos no contiene conexiones que la mayor parte del 
tiempo permanecen inactivas, lo que se traduce en dar servicio a muchos más 
usuarios y facilita la escalabilidad. 


e Las interacciones con la base de datos se realizan mediante órdenes para 
acceso a los datos, que son objetos que encapsulan las sentencias SQL o los 
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procedimientos almacenados que definen la operación a realizar sobre el ori- 
gen de datos. 


e Los datos requeridos normalmente se almacenan en memoria caché en con- 
juntos de datos, lo que permite trabajar sin conexión sobre una copia temporal 
de los datos obtenidos. Los conjuntos de datos son independientes de los orí- 
genes de datos. Cuando sea necesario, se puede restablecer la conexión con la 
base de datos y actualizarla desde el conjunto de datos. 


e En ADO.NET, el formato de transferencia de datos es XML. La representa- 
ción XML de los datos no utiliza información binaria (muchos servidores de 
seguridad bloquean la información binaria), sino que se basa en texto, lo que 
permite enviarla mediante cualquier protocolo, como por ejemplo HTTP. 


Componentes de ADO.NET 


ADO.NET es un conjunto de clases, pertenecientes al espacio de nombres Sys- 
tem.Data, para acceso a los datos de un origen de datos. Dicho de otra forma, 
ADO.NET proporciona un conjunto de componentes para crear aplicaciones dis- 
tribuidas de uso compartido de datos. Dichos componentes están diseñados para 
separar el acceso a los datos de la manipulación de los mismos y son los siguien- 
tes: DataSet y el proveedor de datos de NET Framework, que es un conjunto de 
componentes entre los que se incluyen los objetos conexión (Connection), de ór- 
denes (Command), lector de datos (DataReader) y adaptador de datos (Da- 
taAdapter), que describimos a continuación. 


Como paso previo a esta descripción, para una mejor comprensión, la figura 
siguiente muestra cómo trabajan conjuntamente los objetos mencionados entre sí, 
para que una aplicación pueda interactuar con un origen de datos. 


Formulario E i Conjunto : i Origen de : 
Windows E : de datos : datos 









Conexión 


: Adaptador 
de datos 


de datos 










Conexión 
de datos 







Adaptador 
: de datos 
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De forma resumida se puede decir que el trabajo de conexión con la base de 
datos, o la ejecución de una sentencia SQL determinada para recuperar datos de la 
base de datos, lo realiza el proveedor de acceso a datos. 


En cambio, recuperar esos datos para tratarlos, manipularlos o volcarlos a un 
determinado control o dispositivo es una acción ejecutada por una capa superior 
formada por un conjunto de datos agrupados en tablas. 





System.Data 





A continuación, estudiaremos ambas capas con más detalle, analizando cada 
una de las partes que componen el modelo ADO.NET. 


Conjunto de datos 


Según se observa en las figuras anteriores, un formulario Windows, para acceder 
a los datos de un origen de datos, lo que hace generalmente es utilizar un adapta- 
dor de datos para leer la información de la base de datos y almacenarla en un con- 
junto de datos. Posteriormente, cuando quiera escribir en el origen de datos, 
volverá a utilizar el adaptador que tomará los datos del conjunto de datos. Como 
alternativa, según veremos un poco más adelante, se puede interactuar directa- 
mente con la base de datos utilizando un objeto de órdenes para acceso a los da- 
tos, que incluya una sentencia SQL o una referencia a un procedimiento 
almacenado. 


Un conjunto de datos incluye una o más tablas basadas en las tablas del ori- 
gen de datos y también puede incluir información acerca de las relaciones entre 
estas tablas y las restricciones para los datos que puede contener cada tabla. Las 
partes fundamentales de un conjunto de datos, como veremos a continuación, se 
exponen al programador mediante propiedades y colecciones. 
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En ADO.NET, el componente central de la arquitectura sin conexión es la 
clase de objetos DataSet (conjunto de datos) perteneciente al espacio de nombres 
System.Data, que se puede utilizar con múltiples y distintos orígenes de datos. 


La clase DataSet incluye la colección DataTableCollection de objetos Da- 
taTable (tablas de datos), a la que se obtiene acceso a través de la propiedad Ta- 
bles del DataSet, y la colección DataRelationCollection de objetos 
DataRelation (relaciones entre las tablas). 


A su vez, la clase DataTable incluye la colección DataRowCollection de ob- 
jetos DataRow (filas de tabla), la colección DataColumnCollection de objetos 
DataColumn (columnas de datos) y la colección ConstraintCollection de obje- 
tos Constraint (restricciones). 


Según lo expuesto, un objeto DataSet con varias tablas (solo representamos 
una) tendría la estructura siguiente: 


DataTableCollection 


DataRowCollection 
DataColumnCollection 


ConstraintCollection 


DataRelationCollection 





Así mismo, la clase DataRow incluye la propiedad RowState, que permite 
saber si la fila cambió y de qué modo, desde que la tabla de datos se cargó por 
primera vez. Algunos de los valores que esta propiedad puede tomar son Added, 
Deleted, Modified y Unchanged. 
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Proveedor de datos 


En .NET Framework, un proveedor de datos sirve como puente entre una aplica- 
ción y un origen de datos. Se utiliza tanto para recuperar datos de un origen como 
para actualizarlos. Los componentes principales de un proveedor de datos .NET 
son los objetos siguientes: 


e Conexión con el origen de datos (objeto Connection). Establece una conexión 
a un origen de datos determinado. 


e Orden para acceso a los datos (objeto Command). Ejecuta una orden SQL o 
un procedimiento almacenado en un origen de datos. 


e Lector de datos (objeto DataReader). Proporciona una forma rápida de acce- 
der a los datos recuperados después de una consulta a la base de datos. El ac- 
ceso permitido es solo para leer y hacia delante. 


e Adaptador de datos (objeto DataAdapter). Llena un DataSet y realiza las ac- 
tualizaciones necesarias en el origen de datos. 


A prame 7 
DataReader 


.NET incluye los siguientes proveedores de datos: ODBC, OLE DB, Oracle y 
SQL Server, que podemos encontrar en los espacios de nombres System.Da- 
ta.Odbc, System.Data.OleDb, System.Data.OracleClient y System.Data.SqlClient, 
respectivamente. Cada proveedor de datos tiene una implementación concreta de 
las clases Connection, Command, DataReader y DataAdapter que han sido 
optimizadas para un determinado sistema de gestión de base de datos (SGBD). 
Por ejemplo, si usted necesita crear una conexión con una base de datos de SQL 
Server, utilizará la clase de conexión SqlConnection. 





El proveedor Odbc permite conectar una aplicación a distintos orígenes de 
datos a través de ODBC. El proveedor OleDb permite conectar una aplicación a 
distintos orígenes de datos a través de OLE DB. El proveedor OracleClient es un 
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proveedor de acceso a datos nativo especialmente diseñado para bases de datos 
Oracle. Por último, el proveedor SqlClient es un proveedor de acceso a datos na- 
tivo, que nos permite conectar una aplicación a orígenes de datos Microsoft SQL 
Server 7 o posterior. 


Como vemos, Microsoft proporciona los proveedores de acceso a datos más 
corrientes, pero estos no son todos; no obstante, con ODBC y OLE DB, podemos 
acceder a la inmensa totalidad de ellos. 


Sin embargo, hay muchos motores de bases de datos de igual importancia 
como PostgreSQL, MySQL, AS/400, etc. En estos casos, si queremos utilizar un 
proveedor de acceso a datos nativo, deberemos acudir al fabricante para que nos 
proporcione el conjunto de clases que definen ese proveedor en particular, o bien 
crear nuestro propio proveedor de datos a partir de las clases del espacio de nom- 
bres System.Data.Common que proporciona clases para la creación de objetos 
DbProviderFactory que permiten trabajar con orígenes de datos específicos. 


Es aconsejable, siempre que pueda, utilizar un proveedor de acceso a datos 
nativo para acceder a bases de datos. Esto permitirá aumentar considerablemente 
el rendimiento a la hora de establecer la conexión con un determinado origen de 
datos. 


A primera vista, podría parecer que ADO.NET ofrece un modelo fragmenta- 
do, ya que no incluye un conjunto genérico de objetos que puede trabajar con 
múltiples tipos de bases de datos. Como resultado, si se cambia de un SGBD a 
otro tendrá que modificar su código de acceso de datos para utilizar un conjunto 
diferente de clases. Pero a pesar de que los diferentes proveedores utilicen dife- 
rentes clases, todos ellos se han estandarizado en la misma forma. Más específi- 
camente, cada proveedor se basa en el mismo conjunto de interfaces y clases base. 
Por ejemplo, cada objeto Connection implementa la interfaz IDbConnection, 
que define los métodos básicos, tales como Open y Close. Esta estandarización 
garantiza que todas las clases de conexión funcionarán de la misma manera y ex- 
pondrán el mismo conjunto de propiedades y métodos. 


Objeto conexión 


Para establecer una conexión a un origen de datos, ADO.NET proporciona el ob- 
jeto Connection. Por ejemplo, para establecer una conexión a Microsoft SQL 
Server utilizaremos el objeto SqlConnection, para conectarse a un origen de da- 
tos OLE DB utilizaremos el objeto OleDbConnection, para conectarse a un orl- 
gen de datos ODBC utilizaremos el objeto OdbeComnection y para conectarse a 
un origen de datos de Oracle, utilizaremos el objeto OracleConnection. 
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La función de un objeto conexión es presentar atributos y métodos para per- 
mitir establecer y modificar las propiedades de la conexión (por ejemplo, el iden- 
tificador de usuario y la contraseña, entre otras). 


En el ejemplo siguiente se muestra cómo crear una conexión: 


OleDbConnection conexion = new OleDbConnectioní(strConexion); 


El argumento strConexion hace referencia a la cadena de conexión. La cadena 
de conexión está compuesta por una serie de elementos nombre/valor separados 
por punto y coma. El orden de estos elementos no es importante. En conjunto, es- 
pecifican la información básica necesaria para crear una conexión. Aunque las ca- 
denas de conexión varían según el proveedor de SGBD que se esté utilizando, 
algunos elementos, como los citados a continuación, son casi siempre requeridos: 


e El servidor donde se encuentra la base de datos. 

e La base de datos que desea utilizar. 

e [La autenticación. Oracle y SQL Server darán la opción de suministrar creden- 
ciales de identificación como usuario y contraseña. 


Por ejemplo, la cadena de conexión siguiente se utiliza para conectarse a la 
base de datos SQL Server denominada bd telefonos en el equipo actual utilizando 
la seguridad integrada (esto es, utiliza el usuario actual de Windows para acceder 
a la base de datos): 


string strConexion = "Data Source=.1Asqlexpress;" + 
"Initial Catalog=bd_telefonos; Integrated Security=True"; 


Si la seguridad integrada no es compatible con la conexión, deberá indicar un 
usuario válido junto con una contraseña. Por ejemplo, para una base de datos 
PostgreSq]l, la cadena de conexión podría ser así: 


string strConexion = "SERVER=l0calhost;" + 
"Database=bd_telefonos; User name=****x*x; Password=***X*x*"'; 


Si está utilizando el proveedor OLE DB, la cadena de conexión seguirá siendo 
similar, pero ahora hay que proporcionar un nombre de proveedor que identifique 
el controlador OLE DB que se va a utilizar. Por ejemplo, puede utilizar la siguien- 
te cadena de conexión para conectarse a una base de datos Microsoft Access: 


string strConexion = "Provider=Microsoft.ACE.OLEDB.12.0;" + 
"Data Source=C:./../../bd_telefonos.accdb;"; 


Cuando utilizamos OLE DB en un sistema X64 tenemos que saber que hay 
controladores OLE DB para 32 y para 64 bits. Por ejemplo, el proveedor Micro- 
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soft.Jet.OLEDB.4.0 es para 32 bits y Microsoft. ACE.OLEDB.12.0, dependiendo 
de la versión de Office, puede ser para 32 o para 64 bits. Según esto, habrá que se- 
leccionar X86 o X64 como plataforma de destino en la pestaña Generar de las 
propiedades del proyecto. 


Objeto orden 


Después de establecer una conexión con un origen de datos, puede utilizar un ob- 
jeto Command para ejecutar sentencias SQL y devolver resultados desde ese ori- 
gen de datos. Para crear un objeto de estos, invoque a su constructor. Si el objeto 
ya está creado, la instrucción SQL encapsulada por él podrá ser consultada o mo- 
dificada a través de su propiedad CommandText. 


En el caso de orígenes de datos compatibles con OLE DB, utilice 
OleDbCommand; para orígenes de datos compatibles con ODBC, use Odbe- 
Command; para Microsoft SQL Server, utilice SqlCommand; y para Oracle, 
OracleCommand. En el ejemplo siguiente se muestra cómo crear una orden SQL 
para acceder a un origen de datos compatible con OLE DB: 


0leDbCommand ordenSQL = new OleDbCommand ( 


"SELECT nombre, telefono FROM telefonos”, 
conexion); 


Para ejecutar esta orden contra la base de datos podemos utilizar, básicamen- 
te, alguno de estos métodos: ExecuteNonQuery y ExecuteReader. 


ExecuteNonQuery se utiliza para ejecutar operaciones de manipulación de 
datos como UPDATE, INSERT o DELETE (SELECT no). El valor devuelto co- 
rresponde al número de filas afectadas por la orden ejecutada. Por ejemplo: 


ordenSQL.ExecuteNonQuery():; 


También podemos utilizar este método para ejecutar operaciones de defini- 
ción, por ejemplo CREATE, ALTER o DROP. 


ExecuteReader se utiliza para ejecutar una consulta SELECT y devuelve un 
objeto DataReader. Por ejemplo: 


OleDbDataReader lector = ordenSQL.ExecuteReader(); 
Objeto lector de datos 


Cuando una aplicación solo necesite leer datos (no actualizarlos), no será necesa- 
rio almacenarlos en un conjunto de datos, basta utilizar un objeto lector de datos 
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en su lugar. Un objeto lector de datos obtiene los datos del origen de datos y los 
pasa directamente a la aplicación (un adaptador de datos utiliza un objeto lector de 
datos para llenar un conjunto de datos). 


El objeto lector de datos proporcionado por .NET para SQL Server es SqlDa- 
taReader, y para orígenes OLE-DB es OleDbDataReader. La figura siguiente 
muestra cómo se utilizan estos objetos: 


DalaReader 










Origen de 
datos 


Connection 





El ejemplo siguiente muestra cómo utilizar un lector de datos para obtener el 
resultado proporcionado por la orden SQL SELECT anterior: 


conexion.Open(); 
OleDbDataReader lector = ordenSQL.ExecuteReader():; 


while(lector.Read()) 
Console.WritelLine(lector.GetString(0) + ", " + 
lector.GetString(1)); 
lector.Closeí); 
conexion.Close(); 


El método Read desplaza el cursor del DataReader, de solo lectura y avance 
hacia delante, hasta el siguiente registro. La posición inicial es antes del primer 
registro, por lo tanto, se debe llamar a Read para iniciar el acceso a los datos. Una 
vez finalizada la lectura se debe llamar al método Close para liberar el Data- 
Reader de la conexión, objeto Connection. 


Para recuperar las columnas de la fila actual del conjunto de datos proporcio- 
nado por el DataReader, utilizaremos la funcionalidad proporcionada por este 
objeto; por ejemplo, GetValue obtiene el valor de la columna especificada en su 
formato nativo, GetValues rellena la matriz de objetos pasada como argumento 
con los valores de la fila actual, GetString obtiene el valor de la columna especi- 
ficada como una cadena, GetInt32 obtiene el valor de la columna especificada 
como un entero de 32 bits con signo, etc. 


Adaptador de datos 


Un adaptador es un conjunto de objetos utilizado para intercambiar datos entre un 
origen de datos y un conjunto de datos (objeto DataSet). Esto significa que una 
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aplicación leerá datos de una base de datos para un conjunto de datos y, a conti- 
nuación, manipulará dichos datos. También, en algunas ocasiones, volverá a es- 
cribir en la base de datos los datos modificados del conjunto de datos. 


En el caso de orígenes de datos compatibles con OLE DB, utilice OleDbDa- 
taAdapter junto con sus objetos OleDbCommand y OleDbConnection asocia- 
dos. En el caso de otros orígenes de datos compatibles con ODBC, utilice 
OdbcDataAdapter junto con sus objetos OdbeCommand y OdbcComnection 
asociados. Si se conecta a una base de datos de Microsoft SQL Server, podrá me- 
jorar el rendimiento general utilizando SqlDataAdapter junto con sus objetos 
asociados SqlCommand y SqlComnection. En el caso de bases de datos de Ora- 
cle, utilice OracleDataAdapter junto con sus objetos OracleCommand y Ora- 
cleConnection asociados, del espacio de nombres System.Data.OracleClient, 


Generalmente, cada adaptador de datos, como muestra la figura siguiente, in- 
tercambia datos entre una sola tabla de un origen de datos y un solo objeto Data- 
Table (tabla de datos) del conjunto de datos. Esto quiere decir que lo normal es 
utilizar tantos adaptadores como tablas tenga el conjunto de datos. De esta forma, 
cada tabla del conjunto de datos tendrá su correspondiente tabla en el origen de 
datos. En la siguiente figura se puede observar la utilización de un adaptador de 
datos para llenar un conjunto de datos (objeto DataSet): 


Conjunto 
de datos 






DataAdapter Origen de 


datos 


Connection 


Según se observa en la figura anterior, un adaptador contiene también las pro- 
piedades SelectCommand, InsertCommand, Delete Command, UpdateCom- 
mand y TableMappings para facilitar la lectura y actualización de los datos en 
un origen de datos. 


SelectCommand hace referencia a una orden que recupera filas del origen de 
datos, entendiendo por orden un objeto Command que almacena una instrucción 
SQL o un nombre de procedimiento almacenado, InsertCommand hace referen- 
cia a una orden para insertar filas en el origen de datos, UpdateCommand hace 
referencia a una orden para modificar filas en el origen de datos, y DeleteCom- 
mand hace referencia a una orden para eliminar filas del origen de datos. 
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Modos de conexión 


La acción más pesada cuando realizamos un acceso a una base de datos se en- 
cuentra en la conexión con la base de datos. Esa tarea tan simple es la que más re- 
cursos del sistema consume. Por ello, es bueno tener presente las siguientes 
consideraciones: 


e La conexión debe realizarse, siempre que se pueda, con los proveedores de 
acceso a datos nativos, simplemente porque son más rápidos que los provee- 
dores del tipo OLE DB y ODBC. 


e La conexión debe abrirse lo más tarde posible. Es recomendable definir todas 
las variables que podamos antes de realizar la conexión. 


e La conexión debe cerrarse lo antes posible, siempre y cuando no tengamos la 
necesidad de utilizarla posteriormente. 


Evidentemente, se nos presentarán casos en los que será difícil asumir qué 
acción tomar. Esto es, parece que deberíamos mantener una conexión abierta solo 
en el instante de acceder a la base de datos. Pero ¿y si estamos trabajando conti- 
nuamente con esa base de datos? ¿La penalización sería menor si la mantuviéra- 
mos abierta? No está del todo claro, ya que no existe en sí una regla clara que 
especifique qué acción tomar en cada caso. Por eso, dependiendo de lo que vaya- 
mos a realizar, nos inclinaremos por una acción u otra. 


Lo que sí está claro es que el modelo de datos de ADO.NET que hemos visto 
quedaría resumido, en cuanto a la conectividad se refiere, de la forma indicada en 
la figura siguiente, en la que se pueden observar dos formas de trabajar con los 
datos de una base de datos: conectado a la base de datos y desconectado. 


El objeto DataSet nos ofrece la posibilidad de almacenar datos de una deter- 
minada base de datos (tablas de una base de datos). Esto hace posible que una 
aplicación pueda trabajar con los datos procedentes de una base de datos estando 
desconectada de dicha base. Esta forma de trabajo no significa que dentro del Da- 
taSet podamos abrir una tabla con una cantidad de registros enorme, y trabajemos 
sobre ella creyendo que esto nos beneficiará. Todo lo contrario. Esta práctica pe- 
nalizaría seriamente el rendimiento de nuestra aplicación. 


Obsérvese que el adaptador de datos actúa como puente entre el DataSet y el 
origen de datos para la recuperación y el almacenamiento de datos. Para poder ac- 
tuar como un puente, DataAdapter proporciona el método Fill, que modifica los 
datos de DataSet de forma que coincidan con los del origen de datos, y el método 
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Update, que modifica los datos del origen de datos para hacerlos coincidir con los 
de DataSet. 


Proveedor de accesola datos 





En otras ocasiones será necesario trabajar estando la aplicación conectada a la 
base de datos. Esto es precisamente lo que nos ofrece el objeto DataReader: la 
posibilidad de trabajar con bases de datos conectadas. No obstante, este objeto 
tiene algunas particularidades que conviene conocer y que especificamos a conti- 
nuación: 


e El objeto DataReader recupera un conjunto de valores llenando un pequeño 
búfer de datos. 


e Silos registros que hay en el búfer se acaban, el objeto DataReader regresará 
a la base de datos para recuperar más registros. Por lo tanto, si el servicio de 
SQL Server estuviera detenido en ese momento, o, en su caso, el origen de 
datos estuviera detenido, la aplicación generaría un error a la hora de leer el 
siguiente registro. 


Resumiendo, DataReader es un objeto conectado, pero trabaja en segundo 
plano con un conjunto de datos, por lo que a veces nos podría resultar chocante su 
comportamiento. 
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Probando una conexión 


Una vez generada la base de datos (al principio de este capítulo creamos una base 
de datos SQL Server denominada bd telefonos) y definida la cadena de conexión, 
simplemente tenemos que crear el objeto conexión y utilizar sus métodos Open y 
Close para abrir y cerrar dicha conexión. Podemos ver esto con un ejemplo que 
muestre una ventana con un botón que nos permita abrir y cerrar la conexión, re- 
flejando el estado de la misma en la propia ventana, además de mostrar la versión 
de SQL Server. Para ello, haciendo uso de los conocimientos adquiridos en los 
capitulos anteriores, cree un proyecto Windows, por ejemplo ProbarConexion, y 
diseñe esta ventana: 





f ha 
al Probar conexión =| 





Versión del servidor: 11.00.3128 


La conexion está: Open 
Se accede a la base de datos 
Ahora la conexion está: Closed 


Mostrar datos 




















Una vez diseñada la ventana, añadimos el código que se debe ejecutar para 
abrir y cerrar la conexión. Esto es, en primer lugar, cuando la ventana se muestre, 
crearemos el objeto conexión. Añada por lo tanto el controlador del evento Load 
de la ventana y edítelo como se indica a continuación: 


private void Forml_Load(object sender, EventArgs e) 
( 
// Crear la conexión 
string strConexion = "Data Source=.1A1sqlexpress;" + 
"Initial Catalog=bd_telefonos; Integrated Security=True"; 
con = new SqlConnection(strConexion); 


La referencia con al objeto de conexión la declaramos como un atributo de la 
clase Form] para que esté accesible para toda la ventana: 


public partial class Forml : Form 
( 
private SqlConnection con = null; 


1! 
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Cuando el usuario haga clic en el botón “Mostrar datos”, supuestamente para 
acceder a la base de datos y obtener un conjunto de datos, se abrirá la conexión, se 
obtendrán los datos y se cerrará la conexión. Añada por lo tanto el controlador del 
evento Click del botón y edítelo como se muestra a continuación: 


private void btMostrarDatos_Click(object sender, EventArgs e) 
( 


try 

( 
// Probar a abrir la conexión 
con.Open(); 
tbVersion.Text = "Versión del servidor: " + con.ServerVersion; 
tbEstadoConexion.Text = "La conexion está: "; 
tbEstadoConexion.Text += con.State.ToString():; 
tbEstadoConexion.Text += "\nSe accede a la base de datos"; 








) 

catch (Exception ex) 

( 

// Manipular la excepción 

tbEstadoConexion.Text = "Error al acceder a la base de datos. 
+ ex.Message; 





) 
finally 
( 
// Asegurarse de que la conexión queda cerrada. 
// Aunque la conexión estuviera cerrada, 
// llamar a Close() no produce un error. 
con.Close(); 
tbEstadoConexion.Text += "AnAhora la conexion está: " + 
con.State.ToString(); 


Obsérvese que, pase lo que pase, el bloque finally nos asegura que la cone- 
xión con la base de datos quedará cerrada. 


La versión del SGBD utilizado nos la proporciona la propiedad ServerVer- 
sion del objeto conexión, y el estado de la conexión, la propiedad State. 


Servicio de conexiones 


Abrir una conexión consume una pequeña cantidad de tiempo. Pero piense ahora, 
por ejemplo, en una aplicación web y en las peticiones que le llegarán a la base de 
datos desde múltiples usuarios de la red. En un caso como este, las conexiones se 
abrirán y cerrarán sin parar, una por cada solicitud que se procesa. Esta sobrecar- 
ga, necesaria para establecer una conexión, puede llegar a ser significativa y, evi- 
dentemente, limita la escalabilidad del sistema. 
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Una solución es utilizar un servicio de conexiones o pool de conexiones. Este 
servicio mantiene permanentemente un número de conexiones abiertas con la base 
de datos, las cuales son compartidas por las peticiones que llegan a la misma. Esto 
evita la necesidad de crear y destruir las conexiones todo el tiempo. El servicio de 
conexiones en ADO.NET es completamente transparente para el programador. 
Esto es, cuando un cliente solicita al servidor de bases de datos una conexión lla- 
mando a Open, se sirve directamente desde el servicio de conexiones, en lugar de 
crear una nueva conexión, y cuando un cliente libera una conexión llamando a 
Close o Dispose, esta no se cierra, sino que queda disponible de nuevo para una 
nueva solicitud a través del servicio de conexiones. 


ADO.NET, en sí mismo, no incluye un servicio de conexiones, pero la mayo- 
ría de los proveedores ADO.NET, como ocurre con SQL Server y Oracle, sí im- 
plementan alguna forma del servicio de conexiones. 


Para casos especiales, en la cadena de conexión pueden ser especificados pa- 
rámetros tales como Max Pool Size o Min Pool Size, entre otros. 


ACCESO CONECTADO A UNA BASE DE DATOS 


El siguiente ejemplo establece una conexión con el origen de datos bd_ telefonos, 
base de datos SOL Server, y utilizando un DataReader muestra en una lista los 
datos nombre y telefono de cada uno de los registros de la tabla telefonos. 


a 
a9 Acceso conectado: SQ... Le |El e) 


Ismael Puertas López 934343567 A 
Miguel López Trujillo 942232323 
Manuel Setien Latorre 942555333 
Leticia Aguime Soriano 954345678 
Sonia Febril Para 958565656 
Carmen Tores Saldaña 958737373 r 
Blena Veiguela Suarez 981425323 a 
Ana María Cuesta Suñer 984454545 ká 


























Para implementar el ejemplo anterior, cree un proyecto Windows, por ejem- 
plo AccesoConectado, y diseñe una ventana que contenga una lista, objeto List- 
Box, y un botón, objeto Button. Lo que queremos es mostrar en la lista las filas 
nombre-teléfono obtenidas tras una consulta a la base de datos bd _telefonos que 
se realizará en el instante en el que el usuario haga clic en el botón. Una vez dise- 
ñada la ventana, añadimos el código que se debe ejecutar para mostrar la lista. 
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En primer lugar, cuando la ventana se visualice, crearemos el objeto cone- 
xión. Añada por lo tanto el controlador del evento Load de la ventana y edítelo 
como se indica a continuación: 


private void Forml_Load(object sender, EventArgs e) 
( 
// Crear la conexión 
string strConexion = "Data Source=.1Asqlexpress;" + 
"Initial Catalog=bd_telefonos; Integrated Security=True"; 
ConexionConBD = new SqlConnection(strConexion); 


La referencia ConexionConBD al objeto SqlConnection la declaramos como 
un atributo de la clase Form] para que esté accesible para toda la ventana: 


public partial class Forml : Form 
( 
private SqlConnection ConexionConBD = null; 
private SqlCommand OrdenSql:; 
private SqlDataReader Lector; 
11 


También hemos declarado los atributos OrdenSql, de tipo SqlCommand, pa- 
ra construir la orden SQL que tenemos que ejecutar para obtener las filas nombre- 
telefono y Lector, de tipo SqlDataReader, para ejecutar la orden anterior contra 
la base de datos. Estas operaciones serán ejecutadas desde el controlador del even- 
to Click del botón “Mostrar datos” una vez abierta la conexión con la base de da- 
tos, para después añadir a la lista las filas del conjunto de datos obtenido. Según 
esto, añada este controlador y edítelo como se indica a continuación: 


private void btMostrarDatos_Click(object sender, EventArgs e) 
( 
using (ConexionConBD) 
( 
// Crear una consulta 
string Consulta = "SELECT nombre, telefono FROM telefonos”; 
OrdenSql = new SqlCommand(Consulta, ConexionConBD); 


// Abrir la conexión con la base de datos 
ConexionConBD.Open(); 


// ExecuteReader hace la consulta y devuelve un SqlDataReader 
Lector = OrdenSql.ExecuteReader(); 

// Llamar siempre a Read antes de acceder a los datos 

while (Lector.Read()) // siguiente registro 


( 





lIsTfnos.Items.Add(Lector["nombre"] + " " + 
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Lector["telefono"]); 


l 
J 


// Llamar siempre a Close una vez finalizada la lectura 
Lector.Close(); 
) 


btMostrarDatos.Enabled = false; 
) 


En este caso, para cerrar la conexión con la base de datos utilizamos, como al- 
ternativa a lo ya expuesto anteriormente, una sentencia using. La sentencia using 
define un ámbito fuera del cual se invoca automáticamente al método Dispose del 
objeto que interviene en la misma; en nuestro caso, del objeto ConexionConBD. 
Este objeto tiene que implementar la interfaz IDisposable, cosa que sucede con 
SqlComnection, que es la que obliga a implementar Dispose, método que, en este 
caso, ha sido diseñado para cerrar la conexión encapsulada por SqlConnection. 
Esto ocurrirá cuando se salga del ámbito definido por using, bien porque se al- 
canza el final de dicha sentencia, o bien porque se lanza una excepción. Esto es, 
ocurra lo que ocurra, la conexión quedará siempre cerrada. 


El código anterior, desde un punto de vista gráfico, se corresponde con la ar- 
quitectura siguiente: 


Proveedor de acceso a datos 


DataReader | 
Origen de 


datos 





Connection 





A continuación se presenta otra versión de este mismo ejemplo, pero utilizan- 
do Microsoft Access. La base de datos se denomina también bd_telefonos y la 
forma de crearla fue expuesta anteriormente en este mismo capítulo. 


using System.Data.0leDb; 


public partial class Forml : Form 
( 
private OleDbConnection ConexionConBD; 
private OleDbCommand OrdenSql:; 
private OleDbDataReader Lector; 





public Forml() 
( 

InitializeComponent(); 
) 
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private void Forml_lLoad(object sender, EventArgs e) 
( 
// Crear la conexión 
strina serte caion = "Provider Microsot t- dE OLEDE: 12.3% = 
"Data Source=C:./../../bd_telefonos.acedb;"; 
ConexionConBD = new OleDbConnection(strConexion); 
) 


private void btMostrarDatos_Click(object sender, EventArgs e) 
( 
using (ConexionConBD) 
( 
// Crear una consulta 
string Consulta = "SELECT nombre, telefono FROM telefonos”; 
OrdenSql = new 0OleDbCommand(Consulta, ConexionConBD); 
// Abrir la conexión con la base de datos 
ConexionConBD.Open(); 
// ExecuteReader hace la consulta y devuelve un SqlDataReader 
Lector = OrdenSql.ExecuteReader(); 
// Llamar siempre a Read antes de acceder a los datos 
while (Lector.Read()) // siguiente registro 
( 
IsTfnos.Items.Add(Lector["nombre"] + " " + 
Lector["telefono"]); 
) 
// Llamar siempre a Close una vez finalizada la lectura 
Lector.Close(); 
) 
btMostrarDatos.Enabled = false; 
) 








} 


Cuando utilizamos OLE DB en un sistema X64 con el proveedor Micro- 
soft. ACE.OLEDB.12.0 de 64 bits, habrá que seleccionar X64 como plataforma de 
destino en la pestaña Generar de las propiedades del proyecto. 


ATAQUES DE INYECCIÓN DE CÓDIGO SQL 


Hasta ahora, todos los ejemplos que hemos visto han utilizado cadenas de caracte- 
res para crear órdenes SQL. Eso hace que los ejemplos sean simples, directos y re- 
lativamente seguros, pero no son realistas y no demuestran uno de los riesgos más 
graves para las aplicaciones (en especial, para las aplicaciones web) que interac- 
túan con una base de datos: ataques de inyección de código SQL. 


La inyección de SQL es el proceso de transmisión de código SQL a una apli- 
cación, sin que esto haya sido previsto por el desarrollador de la misma, lo que se 
traduce en un mal diseño de la aplicación, y que afecta solo a las aplicaciones que 
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utilizan cadenas de caracteres para crear órdenes SQL a partir de los valores su- 
ministrados por el usuario. Veamos un ejemplo a partir de la aplicación anterior. 


Consideremos el ejemplo que se muestra en la figura siguiente. En este ejem- 
plo, el usuario introduce un prefijo de teléfono con la intención de mostrar en la 
lista todas las filas con ese prefijo. Vamos a diseñar esta nueva versión de la apli- 
cación modificando la anterior. Para ello, añada a la ventana de la versión anterior 
un objeto TextBox que denominaremos ctSql. 


` 
a Ataques de inyección Err 


Elena Veiguela Suarez 981425323 
Ana María Cuesta Suñer 984454545 


























Ahora, en esta nueva versión de la aplicación, la orden SQL tiene que ser 
creada dinámicamente añadiendo a la misma la información de la caja de texto 
ctSql en el lugar correspondiente: 


string Consulta = "SELECT nombre, telefono FROM telefonos " + 


"WHERE telefono LIKE *"+etSql.Text+"""; 


El resto del código no cambia mucho. Los pocos cambios que vamos a hacer 
son debidos a que ahora la operación “Mostrar datos” podrá repetirse tantas veces 
como queramos, para lo cual deberemos tener en cuenta que el método Dispose 
que cierra la conexión cuando finaliza la sentencia using, también vacía la pro- 
piedad ConnectionString del objeto ConexionConBD, lo que nos obliga a iniciar- 
lo cada vez que se ejecuta el controlador del evento Click del botón. 


public partial class Forml : Form 
( 
private Sqllonnection ConexionConBD = null; 
private SqlCommand OrdenSql:; 

private SqlDataReader Lector; 

private string strConexion = null; 


public Forml() 
( 

InitializeComponent():; 
) 
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private void Forml_Load(object sender, EventArgs e) 


( 


// Crear la cadena de conexión 
strConexion = "Data Source=.11sqlexpress;" + 
"Initial Catalog=bd_telefonos; Integrated Security=True"; 


) 


private void btMostrarDatos_Click(object sender, EventArgs e) 


( 


using (ConexionConBD = new SqlConnection(strConexion)) 


( 


// Crear una consulta 
string Consulta = "SELECT nombre, telefono FROM telefonos " + 


"WHERE telefono LIKE *"+etSql.Text+"*"; 


OrdenSql = new SqlCommand(Consulta, ConexionConBD); 
// Abrir la conexión con la base de datos 
ConexionConBD.Open(); 


// ExecuteRead 
Lector = Orden 
de Ci 
lIsTfnos.Items. 


// LI 


while (Lector. 


{ 
Is 


) 
// LI 


Tfnos.Item 


mpiar la 


amar siem 








amar siem 


er hace la consulta y devuelve un SqlDataReader 
Sql.ExecuteReader(); 

lista 

Clear(); 

pre a Read antes de acceder a los datos 

Read()) // siguiente registro 


s.Add(Lector["nombre"] + " " + 
Lector["telefono"]); 


pre a Close una vez finalizada la lectura 


Lector.Close(); 


a 


El problema es que ahora el usuario puede inyectar código SQL en la caja de 
texto ctSql según muestra la figura siguiente (piense por un momento que, en lu- 
gar de un prefijo, se le solicitara una contraseña): 





le 
al Ataques de inyección bak 














Ismael Puertas López 934343567 a 
Miguel López Trujillo 942232323 
Manuel Setien Latorre 942555333 
Leticia Aguime Soriano 954345678 
Sonia Febril Para 958565656 
Carmen Torres Saldaña 958737373 
Elena Veiguela Suarez 981425323 
Ana María Cuesta Suñer 984454545 








4 lama] 
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En este ejemplo, el usuario hace una entrada, 98%” OR '9”="9, con la inten- 
ción de alterar la sentencia SQL y lo que consigue son todas las filas de la tabla 
telefonos de la base de datos (muchas veces, el primer objetivo de un ataque es un 
mensaje de error y si el error no se maneja correctamente y la información de bajo 
nivel se expone al atacante, esa información puede ser utilizada para lanzar un 
ataque más sofisticado). Esa entrada ha dado lugar a que se cree la siguiente sen- 
tencia SELECT: 


SELECT nombre, telefono FROM telefonos 
WHERE telefono LIKE *98%” OR *9*=*9” 


La condición 9=9, evidentemente, se cumple siempre, razón por la que toda la 
información es expuesta al atacante. Ahora podríamos lanzar un nuevo ataque ma- 
licioso introduciendo la siguiente cadena de texto: 


98%”; DELETE FROM telefonos-- 


Los dos guiones finales comentan el resto del código de la sentencia SQL, en 
este caso el ° (en MySQL se utiliza la # y en Oracle, el ;). El resultado es que se 
muestran las filas que empiezan por 98 pero después se borran todas las filas de la 
tabla telefonos. 


¿Cómo podemos defendernos contra estos ataques? Hay varias formas de ha- 
cerlo. Las más sencillas pueden ser: 


e Sustituir cada ” de la entrada del usuario por dos ° para impedir que un usuario 
malintencionado cierre una cadena antes de tiempo. 


ctSql Text IREPIACE 


e Utilizar la propiedad TextBox.MaxLength para evitar entradas excesivamen- 
te largas si no son necesarias. 


e Validar la entrada. 
e Utilizar órdenes parametrizadas. 
e Utilizar procedimientos almacenados. 
Los objetos Command pueden utilizar parámetros para pasar valores a ins- 
trucciones SQL o a procedimientos almacenados que permiten realizar operacio- 


nes de comprobación de tipos y validación. A diferencia de una sentencia SQL 
como cadena de texto, un parámetro se trata como un valor literal y no como có- 
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digo ejecutable. De esta forma, quedamos protegidos contra ataques por inyección 
de código SQL. 


Órdenes parametrizadas 


Una orden parametrizada utiliza parámetros de sustitución en el texto SQL. Los 
parámetros indican los valores que serán suministrados de forma dinámica, y que 
luego serán enviados a través de la colección Parameters del objeto Command. 
Por ejemplo, tomemos la sentencia SQL del ejemplo anterior: 


SELECT nombre, telefono FROM telefonos WHERE telefono LIKE ‘98%’ 


Se convertiría en algo como esto: 


SELECT nombre, telefono FROM telefonos WHERE telefono LIKE @prefijo 


Los parámetros de sustitución se añaden por separado a la colección Com- 
mand.Parameters. La sintaxis utilizada difiere de unos proveedores a otros. Con 
el proveedor SQL Server, las órdenes parametrizadas utilizan parámetros de susti- 
tución con nombres únicos. Con el proveedor OLE DB, cada valor en el código se 
reemplaza por un signo de interrogación. En cualquier caso, hay que proporcionar 
un objeto Parameter para cada parámetro y añadirlo a la colección Parameters. 
Con el proveedor OLE DB, debe asegurarse de agregar los parámetros en el mis- 
mo orden en que aparecen en la cadena SQL. Éste no es un requisito con el pro- 
veedor de SQL Server, ya que los parámetros son nombrados. 


El ejemplo siguiente reescribe la consulta que implementamos en la aplica- 
ción anterior para eliminar la posibilidad de un ataque de inyección SQL: 


string Consulta = "SELECT nombre, telefono FROM telefonos " + 
"WHERE telefono LIKE @prefijo"; 

OrdenSql = new SqlCommand(Consulta, ConexionConBD); 

OrdenSql.Parameters.AddWithValue("eprefijo", ctSql.Text); 


El parámetro de sustitución puede también ser añadido así: 


OrdenSql.Parameters.Add("Gprefijo”, SqlDbType.VarChar); 
OrdenSql.Parameters["eprefijo"].Value = ctSql.Text; 


Esta forma de proceder ha quedado obsoleta por la posible ambigiiedad con la 
sobrecarga de Add que toma un objeto String y un valor de enumeración 
SqlDbType, ya que el paso de un entero con la cadena podía interpretarse como 
el paso del valor del parámetro o del valor del SqlIDbType correspondiente. 
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Si ahora intentamos realizar el ataque de inyección de código SQL, observa- 
remos que no se devuelve ninguna fila. Eso es porque no hay filas cuyo teléfono 
empiece por el prefijo: 98%” OR '9”="9. Toda la cadena es ahora el prefijo, que es 
lo que realmente queríamos. 


Procedimientos almacenados 


Un procedimiento almacenado define un bloque de sentencias SQL y se almacena 
en la propia base de datos. Los procedimientos almacenados son similares a las 
funciones, pueden aceptar datos (a través de parámetros de entrada) y devolver 
datos (a través de conjuntos de resultados y parámetros de salida), son fáciles de 
mantener, mejoran la seguridad de la aplicación, pueden llamar a otros procedi- 
mientos y mejoran el rendimiento de la aplicación. 


A continuación mostramos un procedimiento almacenado creado para selec- 
cionar los teléfonos de la tabla telefonos que empiecen por un determinado prefijo 
pasado como parámetro. Para añadirlo a la base de datos SQL Server 
bd telefonos, proceda según se explica a continuación: 





E e A X f MainWindow.xaml x ESE 
31% 4 $ 


4 si Conexiones de datos 
a i} ficeballos-pasqlexpress.bd_telefol 
LA Diagramas de base de datos 
La Tablas 
LA Vistas 
[A Procedimientos almacenados 


a Fil Agregar nuevo procedimiento almacenado 
a Si : N 


$ | E Actualizar 
MTS 
E 





Propiedades Alt+Entrar 











1. Desde el EDI Visual Studio, añada una conexión a la base de datos en el ex- 
plorador de servidores (también denominado “explorador de base de datos”). 
También puede añadir el procedimiento almacenado desde la herramienta de 
administración SOL Server Management Studio. 


2. Expanda la base de datos y haga clic con el botón secundario del ratón en el 
nodo Procedimientos almacenados. Después seleccione la opción Agregar 
nuevo procedimiento almacenado. 


3. Se añade el esqueleto del procedimiento almacenado. En el editor, haga clic 
con el botón secundario del ratón y seleccione Insertar SOL para implementar 
la sentencia SQL mostrada a continuación: 
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ALTER PROCEDURE stpro0btenerTfnos 
prefijo varchar(12) 
AS 
SELECT nombre, telefono 
FROM telefonos 
WHERE telefono LIKE Eprefijo 


Este procedimiento almacenado toma un parámetro: un prefijo de teléfono 
con la intención de obtener todas las filas con ese prefijo. A continuación, modifi- 
camos la aplicación anterior para añadir el código fuente que utiliza este procedi- 
miento almacenado: 


OrdenSql = new SqlCommand("stpro0btenerTfnos", ConexionConBD); 
OrdenSql.CommandType = CommandType.StoredProcedure; 
OrdenSql.Parameters.AddWithValue("Eprefijo", ctSql.Text); 


La primera línea del código anterior crea un objeto SqlCommand que encap- 
sula el procedimiento almacenado; obsérvese que su primer argumento es el nom- 
bre del procedimiento almacenado, la segunda línea especifica que el tipo de la 
sentencia es un procedimiento almacenado y la tercera añade el parámetro a la co- 
lección de parámetros de la sentencia SQL. 


Finalmente, ejecute la aplicación y pruebe los resultados. 


TRANSACCIONES 


Una transacción es una secuencia de operaciones realizadas como una sola uni- 
dad; esto es, como una operación atómica. A este tipo de operaciones se les exige 
cuatro propiedades: atomicidad, coherencia, aislamiento y durabilidad (ACID), 
para ser calificadas como transacciones. 


Una transacción debe ser una unidad atómica de trabajo, tanto si, cuando fi- 
naliza, se realizan todas sus modificaciones en los datos como si no se realiza nin- 
guna de ellas; debe dejar todos los datos en un estado coherente (esto es, debe 
mantener la integridad de todos los datos); las modificaciones realizadas por 
transacciones simultáneas se deben aislar de las modificaciones llevadas a cabo 
por otras transacciones simultáneas (esto es, una transacción reconoce los datos en 
el estado en el que estaban antes de que otra transacción simultánea los modificara 
o después de que la segunda transacción haya concluido, pero no reconoce un es- 
tado intermedio); y una vez concluida una transacción, las modificaciones persis- 
ten (durabilidad) aun en el caso de producirse un error del sistema. 


Según lo expuesto, las transacciones garantizan que los datos no se actualicen 
de forma definitiva salvo que todas las operaciones de la unidad transaccional se 
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completen de forma satisfactoria. Dicho de otra forma, el conjunto de operaciones 
debe validarse como una sola: o todo o nada. 


Un ejemplo típico es una transferencia de fondos entre dos cuentas de un ban- 
co. Por ejemplo, si queremos transferir 500 € de la cuenta Cl a la C2 y las cuentas 
tienen de saldo 2000 € y 10 €, respectivamente, los pasos lógicos para realizar la 
transferencia serían: 


pu 


Comprobar si en la cuenta C1 hay dinero suficiente. 
2. Restar 500 € de la cuenta C1, con lo que su saldo pasaría a ser de 1500 €. 
3. Sumar 500 € a la cuenta de C2, con lo que su saldo pasaría a ser 510 € 


Ahora bien, si entre los pasos 2 y 3 el sistema sufre un error inesperado, la 
cuenta C1 quedaría con 1500 € y C2 con 10 €, con lo cual se han volatilizado 500 
€. Lo lógico hubiera sido que tras el error las cuentas hubieran quedado en su es- 
tado inicial. Vemos entonces por qué las transacciones tienen un comportamiento 
de “o todo o nada”. 


Hablar de transacciones es hablar de concurrencia, entendiendo como tal la 
posibilidad de tener varios usuarios accediendo a los recursos orientados a datos 
al mismo tiempo. En este contexto, ¿qué sucedería si un usuario comienza una 
transacción, modifica un dato sin finalizarla y, a continuación, otro usuario quiere 
recuperar el valor de ese dato? ¿El segundo usuario podrá acceder al dato? En ca- 
so afirmativo, ¿qué valor recuperará?, ¿el antiguo o el nuevo? Para garantizar un 
comportamiento correcto deberemos operar dentro de un contexto transaccional 
en el que las transacciones se confirmen o se anulen. 


Por lo tanto, para comenzar una transacción hay que marcar el momento de 
inicio, BEGIN, a partir del cual todas las operaciones efectuadas no serán defini- 
tivas hasta que se decida terminar con ella, ya sea aprobando, COMMIT, o recha- 
zando, ROLLBACK, la transacción. 


Transacción implícita TransactionScope 


La clase TransactionScope del espacio de nombres System.Transactions pro- 
porciona una forma sencilla de marcar un bloque de código para que participe en 
una transacción. 


using (TransactionScope tr = new TransactionScope()) 
( 
using (ConexionConBD = new SqlConnection(strConexion)) 
( 
// Operaciones contra la base de datos 
) 
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tr.Complete(); 


1 
$ 


La transacción comienza una vez que se ha creado un nuevo objeto Transac- 
tionScope. Tal y como se ilustra en el código anterior se recomienda delimitar el 
alcance de la transacción con una sentencia using. Cuando la aplicación termina 
todo el trabajo que tiene que llevar a cabo en una transacción, se debe llamar al 
método Complete, normalmente al final del bloque using, solo una vez, para noti- 
ficar al administrador de transacciones que la transacción se puede confirmar. Si 
no se puede llamar a este método, la transacción se anula, dado que el administra- 
dor de transacciones interpreta esto como un error del sistema. 


Veamos un ejemplo. Modifiquemos la aplicación anterior para que muestre 
ahora la ventana siguiente. Obsérvese que hemos añadido una caja de texto, que 
muestra el teléfono correspondiente al elemento seleccionado en la lista, y un bo- 
tón “Guardar datos”, que permitirá modificar ese teléfono en la base de datos. 


eS - 

al Transacciones La ESA 
| Elena Veiguela Suarez ] 
Ana María Cuesta Suñer | 











38%. Mostrar datos 
susa 

















Una vez finalizado el diseño de la ventana, para facilitar la implementación de 
esta nueva aplicación, vamos a añadir a la misma una clase CTelefono con dos 
propiedades: Nombre y Tfno. Esto permitirá construir una colección de objetos 
con las filas obtenidas de la consulta a la base de datos que vincularemos a la lista. 


class CTelefono 

( 
public string Nombre { get; set; ) 
public string Tfno { get; set; ) 


public CTelefono() {} 
public CTelefono(string nom, string tel) 
( 








ombre = nom; Tfno = tel; 
) 
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El siguiente paso es construir la colección de objetos CTelefono con las filas 
del conjunto de datos obtenido tras la consulta a la base de datos. Después, asig- 
naremos dicha colección al contexto de datos de la lista /sTfmos. Todo esto lo ha- 
remos en el instante de realizar la consulta a la base de datos desde el controlador 
del evento Click del botón “Mostrar datos”: 


private void btMostrarDatos_Click(object sender, EventArgs e) 
( 
try 
( 
using (ConexionConBD = new SqlConnectioní(strConexion)) 
( 
// Procedimiento almacenado 
OrdenSql = new SqlCommand("stpro0btenerTfnos", 
ConexionConBD); 
OrdenSql.CommandType = CommandType.StoredProcedure; 
OrdenSql.Parameters.AddWithValue("eprefijo", ctSql.Text); 
// Abrir la base de datos 
ConexionConBD.Open(); 
// ExecuteReader hace la consulta y devuelve un SqlDataReader 
Lector = OrdenSql.ExecuteReader(); 
// Colección de datos obtenida de la consulta 
List<CTelefono> lista = new List<CTelefono>(); 
string nombre, tfno; 
// Llamar siempre a Read antes de acceder a los datos 
while (Lector.Read()) // siguiente registro 
( 





nombre = Lector["nombre"] as string; 
tfno = Lector["telefono"] as string; 
lista.Add(new CTelefonoí(nombre, tfno)); 
} 
// Llamar siempre a Close una vez finalizada la lectura 
Lector.Close(); 

H Conti cura" la lista 











IsTfnos.DisplayMember = "Nombre"; 
IsTfnos.ValueMember = "Tfno"; 
IsTfnos.DataSource = lista; 


) 
) 
catch (System.Exception ex) 
( 
MessageBox.Show(ex.Message); 
) 
) 





Obsérvese que lista es una colección, de tipo List, de objetos CTelefono. Ca- 
da objeto CTelefono se construye a partir de cada una de las filas obtenidas tras 
ejecutar el método ExecuteReader. Una vez construida la colección, establece- 
mos que sea el origen de datos del ListBox. Este control tiene que mostrar la pro- 
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piedad Nombre del objeto CTelefono correspondiente a la fila actualmente selec- 
cionada y guardar como valor la propiedad Tfno de dicha fila. Para ello, hay que 
asignar a su propiedad DataSource el origen de datos, esto es, la colección List; a 
su propiedad DisplayMember, el dato a mostrar, esto es, la propiedad Nombre; y 
a su propiedad ValueMember, el valor a utilizar cuando se seleccione un elemen- 
to de la lista, esto es, la propiedad Tfno: 





IsTfnos.DisplayMember = "Nombre"; 
IsTfnos.ValueMember = "Tfno"; 
IsTfnos.DataSource = lista; 


El dato teléfono asociado con el elemento seleccionado de la lista lo vamos a 
mostrar en la nueva caja de texto, ctTfno, que hemos añadido, según muestra la fi- 
gura anterior. De esta forma, podremos cambiar su valor y guardar el cambio en la 
base de datos. Para ello, añadimos el controlador del evento SelectedIndexChan- 
ged de /s7fmos y lo editamos como se indica a continuación: 


private void IsTfnos_SelectedIndexChanged(object sender, EventArgs e) 
( 

if (IsTfnos.Selectedindex == -1) return; 

ctTfno.Text = IsTfnos.SelectedValue.ToString(); 
) 


Ahora, cuando el usuario ejecute la aplicación y muestre un conjunto de nom- 
bres en la lista, seleccionará uno para conocer su teléfono o para modificarlo. La 
modificación de un teléfono en la base de datos implica ejecutar el siguiente pro- 
cedimiento almacenado: 


ALTER PROCEDURE stproModificarTfno 
eEtfnoAntiguo varchar(12), 
EtfnoNuevo varchar(12) 

AS 
UPDATE telefonos 
SET telefono=0tfnoNuevo 
WHERE telefono=etfnoAntiguo 


Este procedimiento será ejecutado cuando el usuario haya modificado el telé- 
fono con la intención de cambiarlo y haga clic en el botón “Guardar datos”. Aña- 
da, por lo tanto, este procedimiento almacenado a la base de datos y después, 
añada el controlador del evento Click del botón “Guardar datos” y edítelo como 
se indica a continuación: 


private void btGuardarDatos_Click(object sender, EventArgs e) 
( 

try 

( 
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string strTelefonoAntiguo = IsTfnos.SelectedValue as string; 
string strTelefonoNuevo = ctIfno.Text; 
if (strlelefonoAntiguo == strlelefonoNuevo) return; 
using (TransactionScope tr = new TransactionScope()) 
( 
using (ConexionConBD = new SqlConnection(strConexion)) 


( 











// Procedimiento almacenado 
OrdenSql = new SqlCommand("stproModificarTfno”, 
ConexionConBD); 
OrdenSql.CommandType = CommandType.StoredProcedure; 
OrdenSql.Parameters.AddWithValue("etfnoAntiguo", 
strTelefonoAntiguo):; 
OrdenSql.Parameters.AddWithValue("etfnoNuevo", 
strTelefonoNuevo); 











// Abrir la base de datos 
ConexionConBD.Open(); 

// Ejecutar la sentencia SQL 
OrdenSql.ExecuteNonQuery(); 





SETERO 
n Actualizar los datos de la lista 
btMostrarDatos_Click(sender, e); 
ion (System.Exception ex) 
i MessageBox.Show(ex.Message); 
) 


Este método, para realizar una modificación en la base de datos, inicia una 
transacción, y cuando el método termina todo el trabajo que tiene que llevar a ca- 
bo en dicha transacción, llama al método Complete para notificar al administra- 
dor de transacciones que la transacción se puede confirmar. Si no se puede llamar 
a este método, se anulará la transacción automáticamente, dado que el administra- 
dor de transacciones interpretará esto como un error. 


Transacciones explícitas 


Una transacción explícita es aquélla que define explícitamente el inicio y el final 
de la transacción. Puede especificarse utilizando las interfaces de programación de 
aplicaciones (API) ADO.NET, OLE DB y ODBC o utilizando sentencias SQL. 


Por ejemplo, con el proveedor SqlCliente de ADO.NET utilizaremos el mé- 
todo BeginTransaction de SqlConnection para iniciar una transacción y para fi- 
nalizarla, llamaremos a los métodos Commit (finalizar una transacción 
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correctamente) o Rollback (eliminar una transacción en la que se encontraron 
errores). Según esto, el método btGuardarDatos Click implementado anterior- 
mente también podría escribirse así: 


private void btGuardarDatos_Click(object sender, EventArgs e) 
( 
try 
( 
string strTelefonoAntiguo = IsTfnos.SelectedValue as string; 
string strTelefonoNuevo = ctITfno.Text; 
if (strlelefonoAntiguo == strlelefonoNuevo) return; 





SqlTransaction transaccion = null; 
try 
( 
using (ConexionConBD = new SqlConnection(strConexion)) 
( 
// Procedimiento almacenado 
OrdenSql = new SqlCommand("stproModificarTfno", 
ConexionConBD); 
OrdenSql.CommandType = CommandType.StoredProcedure; 
OrdenSql.Parameters.AddWithValue("etfnoAntiguo", 
strTelefonoAntiguo):; 
OrdenSql.Parameters.AddWithValue("etfnoNuevo", 
strTelefonoNuevo); 











// Abrir la base de datos 

ConexionConBD.Open(); 

LL INUCIENF Vina cr ransacelon 

transaccion = ConexionConBD.BeginTransaction():; 
OrdenSql.Transaction = transaccion; 

// Ejecutar la sentencia SOL 
OrdenSql.ExecuteNonQuery(); 

He Finalizar la transaccion 
transaccion.Commit(); 





) 
) 
catch 
( 
// En caso de error, volver al estado inicial 
transaccion.Rollback(); 
) 
// Actualizar los datos de la lista 
btMostrarDatos_Click(sender, e); 
) 
catch (System.Exception ex) 
( 
MessageBox.Show(ex.Message); 
) 
) 
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La propiedad Transaction de SqlCommand, en este caso, establece la 
transacción SqlTransaction en la que se ejecuta SqlCommand. 


Las transacciones pueden también establecerse en los procedimientos almace- 
nados utilizando instrucciones SQL: 


e BEGIN TRANSACTION. Marca el punto de inicio de una transacción ex- 
plícita para una conexión. 


e COMMIT TRANSACTION o COMMIT WORK. Se utiliza para finalizar 
una transacción correctamente si no hubo errores, llevando a efecto las modi- 
ficaciones correspondientes en la base de datos. 


e ROLLBACK TRANSACTION o ROLLBACK WORK. Se utiliza para 
eliminar una transacción en la que se encontraron errores, volviendo al estado 
inicial, esto es, al que había antes de iniciar la transacción. 


Por ejemplo, en lugar de establecer la transacción en el método btGuardarDa- 
tos_Click implementado anteriormente, podríamos establecerla explícitamente en 
el propio procedimiento almacenado así: 


ALTER PROCEDURE stproModificarTfno 
eEtfnoAntiguo varchar(12), 
EtfnoNuevo varchar(12) 

AS 
BEGIN TRY 

BEG TRANSACTION 

ATE telefonos 

telefono=@tfnoNuevo 

E telefono=@tfnoAntiguo 


o c 








co 
END T 
BEGIN CATCH 
IF (EETRANCOUNT > 0) 
ROLLBACK 
-- Lanzar una excepción indicando el error ocurrido 
DECLARE @ErrMsg nvarchar(4000), @ErrSeverity int 
SELECT @ErrMsg = ERROR_MESSAGE(), 
@ErrSeverity = ERROR_SEVERITY() 
RAISERROR(@ErrMsg, @ErrSeverity, 1) 
END CATCH 














Este ejemplo verifica @@TRANCOUNT para determinar si la transacción es- 
tá en proceso (es el contador de transacciones para la conexión actual; BEGIN 
TRANSACTION incrementa este contador y ROLLBACK o COMMIT lo decre- 
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mentan). Y RAISERROR permite enviar una notificación del error ocurrido para 
informar al usuario, que se traducirá en una excepción de tipo SqlException. 


También puede utilizar transacciones explícitas en OLE DB. En este caso, 
llamaremos al método ITransactionLocal::StartTransaction para iniciar una 
transacción y a ITransaction::Commit o ITransaction::Abort con fRetaining 
establecido en FALSE para finalizar la transacción sin iniciar otra automáticamen- 
te. 


ESCRIBIR CÓDIGO INDEPENDIENTE DEL PROVEEDOR 


Según expusimos al hablar de proveedores de datos y ateniéndonos a los ejemplos 
realizados para acceder a una base de datos SQL Server o Access, observamos 
que si se cambia de un SGBD a otro tenemos que modificar el código de acceso a 
los datos para utilizar un conjunto diferente de clases; esto es así porque la aplica- 
ción depende de un proveedor de datos concreto. No obstante, los cambios han 
sido sencillos porque los diferentes proveedores (en nuestro caso System.Da- 
ta.OleDb y System.Data.SqlClient) se han estandarizado de la misma forma, ga- 
rantizando así que todas las clases funcionarán de la misma manera y expondrán 
el mismo conjunto de propiedades y métodos. 


Para escribir una aplicación que no dependa de un proveedor de datos concre- 
to, ADO.NET incorporó nuevas clases base abstractas en el espacio de nombres 
System.Data.Common, entre ellas DbConnection, DboCommand y DbData- 
Adapter, que también son utilizadas por los proveedores de datos de .NET Fra- 
mework como System.Data.SqlClient y System.Data.OleDb; por ejemplo, 
SqlComnection y OleDbConmnection se derivan de DbConnection. Estas clases, 
basándose en la información acerca del proveedor y de la cadena de conexión su- 
ministrada durante la ejecución, permiten trabajar con objetos de los tipos propor- 
cionados por los distintos proveedores, como SqlConnection u OleDbCon- 
nection, deducidos del proveedor de datos proporcionado. 


Pero ¿cómo generamos esos objetos si las clases del espacio de nombres Sys- 
tem.Data.Common son abstractas? Pues a partir de la clase DbProviderFacto- 
ries. Esta clase proporciona un método static, GetFactory, para crear una 
instancia de DbProviderFactory cuya funcionalidad permite crear durante la eje- 
cución instancias de las clases correspondientes al proveedor suministrado. Este 
modelo de programación para la escritura de código independiente del proveedor 
se basa en el uso del patrón de diseño Factory (factoría): usar un objeto especiali- 
zado solamente para crear otros objetos, de forma muy parecida a como opera una 
fábrica en el mundo real. 
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Por ejemplo, el siguiente código utilizando el objeto factoria de la clase 
DbProviderFactory permite crear instancias de las clases del proveedor Sys- 
tem.Data.SqlClient pasado como argumento al método GetFactory de la clase 
DbProviderFactories: 


DbProviderFactory factoria = 
DbProviderFactories.GetFactory("System.Data.SqlClient"); 


DbConnection con = factoria.CreateConnection(); 
con.ConnectionString = "Data Source=.1Asqlexpress; "+ 
"Initial Catalog=bd_telefonos; Integrated Security=True"; 


Cuando se ejecute este código, la variable con hará referencia a un objeto 
SqlConnection (del proveedor System.Data.SqIClient) creado por el método 
CreateConnection de DbProviderFactory. Esto quiere decir que este código se 
puede generalizar utilizando como parámetros el proveedor y la cadena de cone- 
xión. Por ejemplo, podemos construir una clase Factoria que incluya un método 
static CrearDbConnection que devuelva el objeto conexión para un proveedor y 
una cadena de conexión específicos: 


public class Factoria 
( 
public static DbConnection CrearDbConnection(string proveedor, 
string cadenaCon) 
( 
DbConnection con = null; 
// Crear DbProviderfFactory y DbConnection 
if (cadenaton != null) 
( 
try 
( 
DbProviderFactory factoria = 
DbProviderFactories.GetFactory(proveedor); 
con = factoria.CreateClonnection(); 
con.ConnectionString = cadenaCon; 
) 
catch (Exception ex) 
( 
con = null; 
Console.WriteLine(ex.Message); 





) 
) 
return con; 
) 
1! 
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El proveedor y la cadena de conexión podemos registrarlos en un fichero de 
configuración, App.config, que añadiremos a la aplicación si aun no existe. Por 
ejemplo: 


<2xml version="1.0" encoding="utf-8" ?> 
<configuration> 
<connectionStrings> 
<add name="cc" 
providerName="System.Data.SqlClient" 
connectionString= 
"Data Source=.1sqlexpress; Initial Catalog=bd_telefonos; 
Integrated Security=True" /> 
</connectionStrings> 
</configuration> 








Si en lugar de querer acceder a esa base de datos, queremos acceder a otra, 
simplemente tenemos que editar este fichero de configuración. El fichero de con- 
figuración es un fichero de texto que se puede actualizar sin que la aplicación ne- 
cesite ser recompilada. Por ejemplo: 


<2xml version="1.0" encoding="utf-8" ?> 
<configuration> 
<connectionStrings> 
<add name="cc" 
providerName="System.Data.0OleDb" 
connectionString= 
"Provider=Microsoft.ACE.OLEDB.12.0; 
Data Source=C:./../../bd_telefonos.accdb;" /> 
</connectionStrings> 
</configuration> 








Ahora, para crear el objeto conexión, por ejemplo, cuando se inicie la aplica- 
ción, simplemente tendremos que obtener los datos de configuración y llamar al 
método CrearDbConnection de Factoria, según muestra el código siguiente: 


private void Forml_Load(object sender, EventArgs e) 
( 
// Obtener datos de configuració 
sProveedorBd = 
ConfigurationManager.ConnectionStrings["cc"].ProviderName; 
strConexion = 
ConfigurationManager.ConnectionStrings["cc"].ConnectionString; 
// Crear la conexión 
ConexionConBD = 
Factoria.CrearDbConnectionísProveedorBd, strConexion); 
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Para acceder a los datos registrados en el fichero de configuración, utilizare- 
mos la funcionalidad proporcionada por la clase ConfigurationManager. Con- 
cretamente, su propiedad ConnectionStrings hace referencia a la colección de los 
datos de la sección connectionStrings del fichero de configuración. Cada elemento 
de esta colección es un objeto ConnectionStringSettings y puede ser accedido, 
según vemos en el código anterior, por indexación a través su propiedad Name; 
además, su propiedad ProviderName permite acceder al nombre de proveedor y 
su propiedad ConnectionString, a la cadena de conexión. 


Defina las variables sProveedorBd y strConexion como atributos privados de 
la clase Form1 y ponga los tipos adecuados para los atributos ya existentes: 


private DbConnection ConexionConBD = null; 
private DbCommand OrdenSql; 
private DbDataReader Lector; 
private string sProveedorBd; 
private string strConexion; 


Análogamente, podemos añadir a la clase Factoria otros métodos static; por 
ejemplo, CrearDbCommand para crear un objeto DbCommand y CrearDbDa- 
taAdapter para crear un objeto DbDataA dapter. 


El siguiente método devuelve un objeto DbCommand que encapsula la orden 
SQL pasada como argumento que se desea ejecutar contra la base de datos especi- 
ficada por el objeto DbConnection pasado también como argumento: 


public static DbCommand CrearDbCommand(DbConnection con, 
string ordenSQL) 
( 
DbCommand ordenBd = null; 
if (con != null) 
( 
try 
( 
ordenBd = con.CreateCommand(); 
ordenBd.CommandText ordenSQL; 
ordenBd.CommandType = CommandType.Text; 





) 
catch (Exception ex) 


( 





Console.WritelLine("Error: (0)", ex.Message):; 
) 
) 
else 
( 
Console.Writeline("Error: DbConnection es null"); 


) 
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return ordenBd; 


} 


Este otro método mostrado a continuación devuelve un objeto DbDataAdap- 
ter, configurado para un proveedor y una cadena de conexión especificos, que en- 
capsula las órdenes SQL pasadas como argumento que se desea ejecutar contra la 
base de datos especificada por las mismas: 


public static DbDataAdapter CrearDbDataAdapter(string proveedor, 

DbCommand ordenSe) 

( 
DbDataAdapter adaptador = null; 
try 
( 

// Crear DbProviderfFactory y DbConnection. 
DbProviderFactory factoria = 
DbProviderFactories.GetFactory(proveedor); 
// Crear el objeto DbDataAdapter 
adaptador = factoria.CreateDataAdapter(); 
adaptador.SelectCommand = ordenSe; 
DbCommandBuilder cb = factoria.CreateCommandBuilder(); 
// Objeto DbDataAdapter para el que se generan 
// automáticamente instrucciones SQL 
cb.DataAdapter = adaptador; 
adaptador.InsertCommand = cb.GetInsertCommand(); 
adaptador .Deletelommand = cb.GetDeleteCommand(); 
adaptador .UpdatelCommand = cb.GetUpdateCommand(); 














) 
catch (Exception ex) 


( 





Console.Writeline(ex.Message); 
) 
return adaptador; 


} 


La clase abstracta DbCommandBuilder permite generar automáticamente 
órdenes (objetos DbCommand), para una sola tabla, necesarias para actualizar la 
base de datos con los cambios realizados en un objeto DataSet obtenido de la 
misma. Precisamente, su propiedad DataAdapter hace referencia al objeto 
DbDataAdapter para el que se generan automáticamente esas órdenes. 


Como ejemplo, vamos a construir la misma aplicación que realizamos en el 
apartado Acceso conectado a una base de datos, pero utilizando ahora la clase 
Factoria. Entonces, partiendo del proyecto anterior, modifique el método 
Forml1_Load, de la forma expuesta anteriormente, para construir el objeto Cone- 
xionConBD, añada la clase Factoria y el fichero de configuración app.config que 
acabamos de exponer y, después, simplemente modifique el controlador del botón 
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“Mostrar datos” como se indica a continuación. La modificación a realizar depen- 
derá del modo de acceso. Esto es, si se utiliza el acceso conectado, modifique el 
método btMostrarDatos Click así: 


private void btMostrarDatos_Click(object sender, EventArgs e) 


( 


using (ConexionConBD) 


( 


) 


// Crear una consulta 

string Consulta = "SELECT nombre, telefono FROM telefonos”; 
OrdenSql = Factoria.CrearDbCommand(ConexionConBD, Consulta); 
// Abrir la conexión con la base de datos 
ConexionConBD.Open(); 


// ExecuteReader hace la consulta y devuelve un DbDataReader 
Lector = OrdenSql.ExecuteReader(); 

// Llamar siempre a Read antes de acceder a los datos 

while (Lector.Read()) // siguiente registro 

( 





IsTfnos.Items.Add(Lector["nombre"] + " " + 
Lector["telefono"]); 

) 
// Llamar siempre a Close una vez finalizada la lectura 
Lector.Close(); 








btMostrarDatos.Enabled = false; 


} 


Y si se utiliza el acceso desconectado, cuestión que estudiaremos a continua- 


ción, habría que modificar el método btMostrarDatos_Click así: 


private void btMostrarDatos_Click(object sender, EventArgs e) 


( 


using (ConexionConBD) 


( 


// Crear una consulta 

string Consulta = "SELECT nombre, telefono FROM telefonos”; 
OrdenSql = Factoria.CrearDbCommand(ConexionConBD, Consulta); 
// Abrir la conexión con la base de datos 
ConexionConBD.0Open(); 


// Crear y configurar un objeto DbDataAdapter 

DbDataAdapter da = Factoria.CrearDbDataAdapter(sProveedorBd, 
OrdenSql); 

// Crear un DataSet y llenarlo con el resultado de la consulta 
DataSet ds = new DataSet(); 

da.Fill(ds, "telefonos"); 

IsTfnos.DisplayMember = "nombre"; 

lIsTfnos.ValueMember = "telefono"; 
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IsTfnos.DataSource = ds.Tables["telefonos"]; 
) 
btMostrarDatos.Enabled = false; 


CONSTRUIR COMPONENTES DE ACCESO A DATOS 


En aplicaciones profesionales, el código de acceso a la base de datos está encap- 
sulado en clases dedicadas a este tipo de operaciones. De esta forma, la aplica- 
ción, cliente de la base de datos, cuando tiene que ejecutar una operación contra la 
misma, crea un objeto de la clase adecuada y llama al método apropiado. 


A la hora de crear estos componentes de acceso a datos es aconsejable seguir 
unas reglas básicas: 


e Abrir y cerrar las conexiones rápidamente para favorecer la escalabilidad. 

e Implementar código para manipular posibles errores. 

e Seguir prácticas de diseño sin estado; esto es, toda la información necesaria 
para un método debe ser pasada a través de sus parámetros y el valor obtenido 
debe también ser retornado por el mismo. 

e Cada consulta realizada a la base de datos debe recuperar solo las columnas 
necesarias. 

e Un buen diseño sugiere crear una clase para cada tabla de la base de datos o 
para un grupo lógicamente relacionado de tablas. 

e Implementar un método por cada operación de inserción, borrado, modifica- 
ción o selección. 

e Utilizar procedimientos almacenados para cada operación sobre la base de da- 
tos. 


La figura siguiente describe el modelo de datos que estamos proponiendo: 
Capa de presentación 
INTERFAZ GRÁFICA DE USUARIO (GUI) 
apa de lógica de negocio 
BLL (Business Logic Layer) 
Capa de acceso a datos 
DAL (Data Access Layer) 


Base de datos 










Objetos de negocio 
BO (Business Object) 
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La base de datos incluirá los procedimientos almacenados necesarios para to- 
das las operaciones que se desee realizar. 


La capa de acceso a datos es la capa que interactúa con la base de datos. Co- 
mo hemos sugerido anteriormente, su diseño está basado en la creación de una 
clase por cada tabla en la base de datos. Cada una de estas clases deberá definir un 
método por cada procedimiento almacenado relacionado con la tabla en cuestión. 


Para intercambiar información entre la capa de acceso a datos y la capa de 
presentación se utilizarán objetos de negocio. Esta técnica está fundamentada en 
el patrón DTO (Data Transfer Object), también conocido como Value Object 
(VO). Un objeto de negocio se construye a partir de una clase que, generalmente, 
solo contiene propiedades que se corresponden, en la mayoría de los casos, con 
las columnas que define cada tabla. Su misión principal es servir de contenedor 
destinado exclusivamente a la transferencia de información. 


Opcionalmente, podemos añadir otra capa con más lógica de negocio. En esta 
capa, cuando sea preciso, se pueden comprobar las reglas de negocio y los datos 
devueltos por la capa de acceso a datos, manipulándolos si es necesario, antes de 
enviarlos a la capa de presentación, para lo cual podrá utilizar los objetos de ne- 
gocio. Cada clase de esta capa, normalmente, contendrá la misma interfaz pública 
que su clase análoga en la capa de acceso a datos. Estos métodos realizarán fun- 
ciones de validación y de filtrado de datos antes de llamar a sus homólogos en la 
capa de acceso a datos. 


La capa de presentación implementa la interfaz gráfica que será presentada 
por la aplicación al usuario. 


El siguiente ejemplo demuestra cómo implementar este modelo de datos que 
acabamos de describir. 


Capa de presentación 


Deseamos realizar una aplicación que muestre una ventana como la de la figura 
siguiente. Obsérvese que, básicamente, la ventana tiene un control Data- 
GridView que permitirá presentar los datos de la tabla telefonos de la base de da- 
tos bd telefonos, modificar esos datos, borrar filas y añadir nuevas filas. El 
usuario realizará todas estas operaciones sobre el control DataGridView y, evi- 
dentemente, serán reflejadas sobre la base de datos. El DataGridView presentará 
dos columnas visibles, nombre y teléfono, y las columnas dirección y observacio- 
nes se podrán ver utilizando la barra de desplazamiento horizontal. Según lo ex- 
puesto, a falta de establecer los enlaces a datos, el diseño, que posponemos para 
un poco más adelante, podría ser así: 
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a Componentes de acceso a datos 
Lista de teléfonos: 
Nombre Teléfono a 
Francisco Ceballos Femández | 111555999 | | 
¡EEE 
| Javier Ceballos Femández 911234567 | 
Roberto Canales Mora [916753306 L- 
| Pedro Aguado Rodríguez 918888888 
Alfons González Pérez ] [3933333333 
Ismael Puertas López 934343567 
Miguel López Trujillo 1942232323 + 
4 m + 




















Operaciones contra la base de datos 


El siguiente paso es analizar qué operaciones deseamos realizar contra la base de 
datos y escribir los procedimientos almacenados correspondientes. Según hemos 
indicado anteriormente, la aplicación deberá mostrar las filas de la tabla telefonos 
y permitir añadir, borrar o modificar cualquier fila de dicha tabla, por lo tanto, las 
operaciones que vamos a implementar son: 


1. 


Obtener la fila de la tabla correspondiente a un número de teléfono determi- 
nado, lo cual requiere ejecutar el siguiente procedimiento almacenado: 


ALTER PROCEDURE dbo.stpro0btenerFilaTfnos 
telefono varchar(12) 
AS 
SELECT nombre, direccion, telefono, observaciones 
FROM telefonos 
WHERE telefono=0telefono 


Mostrar todas las filas de la tabla telefonos, lo cual exige recuperarlas de la 
misma, operación que realiza el siguiente procedimiento almacenado: 


ALTER PROCEDURE dbo.stpro0btenerFilasTfnos 

AS 
SELECT nombre, direccion, telefono, observaciones 
FROM teléfonos 


Insertar una fila en la tabla, operación que realiza el siguiente procedimiento 
almacenado: 


ALTER PROCEDURE dbo.stprolnsertarFilalfnos 
nombre varchar(30), 
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direccion varchar(30), 
telefono varchar(12), 
observaciones varchar(240) = "Ninguna" 
AS 
INSERT INTO telefonos 
(nombre, direccion, telefono, observaciones) 
VALUES (Onombre, direccion, Otelefono, Cobservaciones) 


4. Borrar una fila de la tabla, operación que realiza el siguiente procedimiento 
almacenado: 


ALTER PROCEDURE dbo.stproBorrarFilalfnos 
telefono varchar(12) 

AS 
DELETE FROM telefonos 
WHERE (telefono = Gtelefono) 


5. Modificar una fila de la tabla. Esta operación requiere ejecutar uno de los pro- 
cedimientos almacenados siguientes, dependiendo de que se modifique o no 
la clave telefono: 


ALTER PROCEDURE dbo.stproActualizarNomDirObs 
Enombre varchar(30), 
direccion varchar(30), 
telefono varchar(12), 
Cobservaciones varchar(240) 
AS 
UPDATE telefonos 
SET nombre = @nombre, direccion = QOdireccion, 
observaciones = observaciones 
WHERE (telefono = Etelefono) 





ALTER PROCEDURE dbo.stproActualizarNomDirTfnObs 
Enombre varchar(30), 
direccion varchar(30), 
EtfnoAntiguo varchar(12), 
EtfnoNuevo varchar(12), 
Cobservaciones varchar(240) 
AS 
PDATE telefonos 
ET nombre = @nombre, direccion = @direccion, 
telefono = @tfnoNuevo, observaciones = @observaciones 
WHERE (telefono = @tfnoAntiguo) 


mA 





Objetos de negocio 


Para facilitar el intercambio de datos entre la capa de presentación y la capa de 
acceso a datos vamos a crear una clase CTelefonosBO que proporcione todas las 
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columnas de la tabla telefonos como propiedades públicas, a las que añadiremos 
una más para seguir la pista a las modificaciones realizadas sobre el conjunto de 
datos recuperado. Esta clase puede escribirse así: 


using System.ComponentModel'; 


namespace ComponentesAccesoDatos 


( 


class CTelefonoB0 : INotifyPropertyChanged 


( 


private string _nombre; 
public string Nombre 
( 





get { return _nombre; } 
set 
( 
_nombre = value; 
OnPropertyChanged(new PropertyChangedEventArgs("Nombre")); 
) 
) 


private string _direccion; 
public string Direccion 
( 
get { return _direccion; ) 
set 
( 
_direccion = value; 
OnPropertyChanged(new PropertyChangedEventArgs("Direccion")); 
) 
) 


private string _telefono; 

public string Telefono 

( 
get { return _telefono; } 
set 
( 





_telefono = value; 
OnPropertyChanged(new PropertyChangedEventArgs("Telefono")); 
) 
) 


private string _observaciones; 
public string Observaciones 
( 
get [ return _observaciones; ) 
set 
( 


_observaciones = value; 
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OnPropertyChanged(new PropertyChangedEventArgs("Observaciones")); 
) 
) 


public CTelefonoBO() {} 





public CTelefonoBO(string nom, string dir, string tel, 
string obs = null) 
( 
Nombre = nom; Direccion = dir; Telefono = tel; 
Observaciones = obs; 


) 


private bool _modificado; 

public bool Modificado 

( 
get { return _modificado; } 
set [ _modificado = value; } 


) 


public event PropertyChangedEventHandler PropertyChanged; 





public void OnPropertyChanged(PropertyChangedEventArgs e) 
if (PropertyChanged != null) 
_modificado = true; 
PropertyChanged(this, e); // generar evento 
) 


La clase CTelefonoBO implementa la interfaz INotifyPropertyChanged para 
notificar a los clientes enlazados de los cambios que se produzcan en sus propie- 
dades. La interfaz de esta clase la componen cinco propiedades: Nombre, Direc- 
cion, Telefono, Observaciones y Modificado. Las cuatro primeras se corresponden 
con las columnas de la tabla telefonos y la quinta permitirá seguir la pista a las 
modificaciones realizadas sobre el conjunto de datos inicialmente recuperado de 
la base de datos; esto es, permitirá conocer qué filas se han añadido o modificado, 
información necesaria para actualizar la base de datos en un instante determinado. 


Para trabajar con colecciones de objetos CTelefonoBO, añadiremos también 
una clase ColCTelefonos derivada de BindingList<7>, la cual fue estudiada en el 
capitulo Enlace de datos en Windows Forms, que permite utilizar enlaces dinámi- 
cos que actualizan la IU de forma automática. 


using System.ComponentModel'; 
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namespace ComponentesAccesoDatos 

( 
class ColCTelefonos : BindingList<CTelefonoB0> 
( 
) 

) 


Capa de acceso a datos 


La capa de acceso a datos implementará las clases que proporcionen la interfaz 
necesaria para interactuar con la base de datos. En nuestro caso, vamos a crear una 
clase denominada CTelefonoDAL que defina un método por cada procedimiento 
almacenado que implementamos anteriormente para satisfacer las operaciones re- 
lacionadas con la tabla telefonos. Esta clase puede escribirse así: 


using System; 

using System.Data.SqlClient; 

using System.Data; 

namespace ComponentesAccesoDatos 

( 
class ClTelefonoDAL 
( 





private string strConexion; 


public CTelefonoDAL() 
( 
// Obtener la cadena de conexión 
strConexion = "Data Source=.1Asqlexpress;" + 
"Initial Catalog=bd_telefonos; Integrated Security=True"; 
) 


public CTelefonoDAL(string strCon) 

( 
// Establecer la cadena de conexión especificada 
strConexion = strCon; 

) 





public CTelefonoBO ObtenerFilalfnos(string tfno) 
( 
) 


public ColCTelefonos ObtenerFilasTfnos() 
( 
) 


public string InsertarFilaTfnos(CTelefonoBO bo) 
( 
) 
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public void BorrarFilaTfnos(string tfno) 


public void ActualizarNomDirTfnO0bs(CTelefonoBO bo, 
string tfnoAntiguo) 


public void ActualizarNomDir0bs(CTelefonoBO bo) 


Observamos que la clase CTelefonoDAL implementa dos constructores, que 
permiten establecer la cadena de conexión con la base de datos, y los métodos Ob- 
tenerFilaTfnos, ObtenerFilasTfnos, InsertarFilaTfnos, BorrarFilaTfnos, Actuali- 
zarNomDirTfnObs y ActualizarNomDirObs. 


El método ObtenerFilaTfnos recupera la fila de la tabla telefonos de la base 
de datos que se corresponda con el teléfono pasado como argumento y devuelve el 
objeto CTelefonoBO correspondiente: 


public CTelefonoBO ObtenerFilaTfnosí(string tfno) 
( 
try 
( 
using (SqlConnection Conexion = new SqlConnection(strConexion)) 
( 
SqlCommand OrdenSql = 
new SqlCommand("stpro0btenerFilaTfnos", Conexion); 
OrdenSql.CommandType = CommandType.StoredProcedure; 
// Parámetros 
OrdenSql.Parameters.AddWithValue("Otelefono”, tfno); 
// Abrir la base de datos 
Conexion.Open(); 
SqlDataReader lector = OrdenSql.ExecuteReader(); 
if (lector.Read()) 
( 

CTelefonoBO fila = new CTelefonoBO( 
(string)lector["nombre"], 
(string)lector["direccion"], 
(string)lector["telefono"], 
(string)lector["observaciones"]); 

return fila; 

) 
return null; 
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) 
catch (SqlException err) 
( 
throw new ApplicationException("Error SELECT telefonos por 1D"); 
) 
) 


ObtenerFilasTfnos devuelve una colección de objetos CTelefonoBO corres- 
pondientes a todas las filas de la tabla telefonos: 


public ColCTelefonos ObtenerFilasTfnos() 
( 
try 
( 
using (SqlConnection Conexion = new SqlConnection(strConexion)) 
( 
SqlCommand OrdenSql = 
new SqlCommand("stpro0btenerFilasTfnos", Conexion); 
OrdenSql.CommandType = CommandType.StoredProcedure; 


// Crear una colección para todos los teléfonos 
ColCTelefonos colTelefonos = 
new ColCTelefonos(); 
// Abrir la base de datos 
Conexion.Open():; 
SqlDataReader lector = OrdenSql.ExecuteReader(); 
while (lector.Read()) 
( 

CTelefonoBO fila = new ClelefonoBO( 
(string)lector["nombre"], (string)lectorl"direccion"], 
(string)lector["telefono"], 
(string)lector["observaciones”]); 

colTelefonos.Add(fila); 





=u 


) 
return colTelefonos; 
) 

) 
catch (SqlException err) 
( 





throw new ApplicationException("Error SELECT telefonos”); 
) 
) 


InsertarFilaTfnos añade una nueva fila a la tabla telefonos, la correspondiente 
al objeto CTelefonoBO pasado como argumento: 


public string InsertarFilaTfnos(CTelefonoBO bo) 
( 

try 

( 
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using (SqlConnection Conexion = new SqlConnectioní(strConexion)) 
( 
SqlCommand OrdenSql = 
new SqlCommand("stprolnsertarFilaTfnos", Conexion); 
OrdenSql.CommandType = CommandType.StoredProcedure; 
// Parámetros 
OrdenSql.Parameters.AddWithValue("Enombre", bo.Nombre)'; 
OrdenSql.Parameters.AddWithValue("edireccion", bo.Direccion); 
OrdenSql.Parameters.AddWithValue("telefono”", bo.Telefono); 
OrdenSql.Parameters.AddWithValue("Gobservaciones", 
bo.Observaciones); 








// Abrir la base de datos 
Conexion.Open():; 
OrdenSql.ExecuteNonQuery(); 
return (string)OrdenSql.Parameters["ftelefono"].Value; 
) 
) 
catch (SqlException err) 
( 
throw new ApplicationException("Error INSERT telefonos”); 
) 
) 


BorrarFilaTfnos borra la fila de la tabla telefonos que se corresponde con el 
teléfono pasado como argumento: 


public void BorrarFilalfnosístring tfno) 
( 
try 
( 
using (SqlConnection Conexion = new SqlConnection(strConexion)) 
( 
SqlCommand OrdenSql = 
ew SqlCommand("stproBorrarFilalfnos", Conexion); 
OrdenSql.CommandType = CommandType.StoredProcedure; 
// Parámetros 
OrdenSql.Parameters.AddWithValue("Etelefono", tfno); 





// Abrir la base de datos 
Conexion.Open(); 
OrdenSql.ExecuteNonQuery(); 
) 
) 
catch (SqlException err) 
( 
throw new ApplicationException("Error DELETE telefonos”); 
) 





} 


CAPÍTULO 13: ACCESO A UNA BASE DE DATOS 549 


ActualizarNomDirTfnObs actualiza la fila de la tabla telefonos que se corres- 
ponde con el teléfono pasado como argumento, con los datos del objeto CTelefo- 
noBO pasado también como argumento: 


public void ActualizarNomDirTfnO0bs(CTelefonoBO bo, string tfnoAntiguo) 
( 
try 
( 
using (SalConnection Conexion = new SqglConnectioní(strConexion)) 
( 
SqlCommand OrdenSql = 
ew SqlCommand("stproActualizarNomDirTfn0bs", Conexion); 
OrdenSql.CommandType = CommandType.StoredProcedure; 
// Parámetros 
OrdenSql.Parameters.AddWithValue("Enombre", bo.Nombre); 
OrdenSql.Parameters.AddWithValue("Edireccion", bo.Direccion); 
OrdenSql.Parameters.AddWithValue("EtfnoAntiguo”, 
tfnoAntiguo); 
OrdenSql.Parameters.AddWithValue("EtfnoNuevo", bo.Telefono); 
OrdenSql.Parameters.AddWithValue("Gobservaciones", 
bo.Observaciones); 



































// Abrir la base de datos 
Conexion.Open():; 
OrdenSql.ExecuteNonQuery(); 
) 
) 
catch (SqlException err) 
( 
throw new ApplicationException("Error INSERT telefonos”); 
) 
) 


Y ActualizarNomDirObs es análoga a ActualizarNomDirTfnObs, excepto en 
que no modifica la columna telefono: 


public void ModificarNomDirO0bs(CTelefonoBO bo) 
( 
try 
( 
using (SalConnection Conexion = new SqglConnectioní(strConexion)) 
( 
SqlCommand OrdenSql = 
ew SqlCommand("stproActualizarNomDir0bs", Conexion); 
OrdenSql.CommandType = CommandType.StoredProcedure; 
// Parámetros 
OrdenSql.Parameters.AddWithValue("Enombre", bo.Nombre); 
OrdenSql.Parameters.AddWithValue("Edireccion", bo.Direccion); 
OrdenSql.Parameters.AddWithValue("etelefono", bo.Telefono); 
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OrdenSql.Parameters.AddWithValue("Cobservaciones", 
bo.Observaciones); 


// Abrir la base de datos 
Conexion.Open(); 
OrdenSql.ExecuteNonQuery(); 
) 
) 
catch (SqlException err) 


( 
throw new ApplicationException("Error INSERT telefonos”); 


) 
) 


Capa de lógica de negocio 


Opcionalmente, podemos añadir otra capa de lógica de negocio que interactúe con 
la capa de presentación y con la capa de acceso a datos. Cada clase de esta capa, 
normalmente, contendrá la misma interfaz pública que su clase análoga en la capa 
de acceso a datos, y sus métodos realizarán, si es preciso, funciones de validación 
y de filtrado de datos antes de llamar a sus homólogos en la capa de acceso a da- 
tos. A modo de ejemplo, vamos a añadir una clase CTelefonoBLL cuyos métodos, 
en principio, simplemente llamarán a sus homólogos de la capa de acceso a datos: 


namespace ComponentesAccesoDatos 


( 
class CTelefonoBLL 


( 
private CTelefonoDAL bd = new CTelefonoDAL(); 
public CTelefonoBO ObtenerFilaTfnos(string tfno) 


eturn bd.ObtenerFilalfnos(tfno):; 


public ColCTelefonos ObtenerFilasTfnos() 


O 
o 


ICTelefonos coTfnos = bd.ObtenerFilasTfnos(); 
eturn colfnos; 





pa 


public string InsertarFilaTfnos(CTelefonoBO bo) 


eturn bd.InsertarFilalfnosíbo):; 








= 


public void BorrarFilaTfnos(string tfno) 
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bd.BorrarFilaTfnos(tfno); 


public void ActualizarNomDirTfn0bs(CTelefonoBO bo, 
string tfnoAntiguo) 
( 
bd.ActualizarNomDirTfn0bsí(bo, tfnoAntiguo):; 
) 


public void ActualizarNomDirO0bs(CTelefonoBO bo) 
( 











bd.ActualizarNomDirObs(bo); 


1 
f 


Diseño de la capa de presentación 


Según lo expuesto, desde la caja de herramientas, arrastramos un control Data- 
GridView sobre el formulario y le asignamos el nombre dgTelefonos. Acorde a la 
información que tiene que mostrar esta rejilla, el origen de datos de la misma será 
una colección de tipo ColCTelefonos de objetos CTelefonoBO. Para configurar es- 
te origen de datos, Visual Studio proporciona un asistente que podemos ejecutar 
seleccionando la opción Agregar nuevo origen de datos, bien desde el menú Pro- 
yecto de Visual Studio, o bien desde la ventana Orígenes de datos que podemos 
visualizar seleccionando la opción Ver > Otras ventanas > Orígenes de datos. 
También podemos acceder a este asistente desde la opción Elegir origen de datos 
> Agregar origen de datos... del menú de tareas del DataGridView. 


Una vez mostrado el asistente, elegimos Objeto como tipo de origen de datos, 
ya que nuestro origen de datos va a ser un objeto de la clase Co/CTelefonos. 


FE = h | 
Asistente para la configuración de orígenes de datos bes 








F- Elegir un tipo de origen de datos 


¿De dónde obtendrá la aplicación los datos? 


Y o p 3 


Base de datos Servicio Objeto SharePoint 























Permite elegir objetos que se pueden usar posteriormente para generar controles enlazados a datos. 


En el siguiente paso se nos permitirá seleccionar ese objeto de datos, o tipo de 
objeto datos, entre los existentes en nuestra aplicación, según se puede observar 
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en la figura mostrada a continuación. Obsérvese que hemos elegido, por lógica, la 
colección Co!CTelefonos, pero el resultado sería el mismo si hubiéramos elegido 
el tipo CTelefonosBO de sus elementos. 


r = 
Asistente para la configuración de orígenes de datos bak) 








F- Seleccionar los objetos de datos 


Expanda los ensamblados y los espacios de nombres a los que se hace referencia para seleccionar objetos. Si falta 
un objeto en un ensamblado al que se hace referencia, cancele el asistente y recompile el proyecto que contiene el 
objeto. 
¿A qué objetos desea enlazar? 
[a mE ComponentesAccesoDatos | Agregar referencia... 
a Ei} ComponentesAccesoDatos araa ES 
l [4] % ColCTelefonos 
[11% CTelefonoBLL 
fg CTelefonoBO 
fg CTelefonoDAL 
101% Form1 
Eleg Program 
El} ComponentesAccesoDatos.Properties 


z 
| B 











[Y] Ocultar ensamblados del sistema 


< Anterior Cancelar | 




















Una vez configurado el origen de datos, podremos observar que se ha añadido 
a la aplicación un objeto BindingSource, denominado colCTelefonosBinding- 
Source, que actuará como intermediario entre el origen de datos y el control Da- 
taGridView. Por lo tanto, si echamos una ojeada al código generado, observare- 
mos que la propiedad DataSource de la rejilla no tiene como valor directamente 
el objeto colección, sino que tiene asignado ese objeto BindingSource, 


this.dgTelefonos.DataSource = this.colCTelefonosBindingSource; 


y la propiedad DataSource del BindingSource es quien tiene asignado el origen 
de datos, aunque no exactamente, porque aún no está creado, por eso, según 
muestra la línea de código siguiente, se le ha asignado el objeto Type devuelto 
por typeof, que proporciona información acerca de los metadatos del tipo pasado 
como argumento, en este caso del tipo ColCTelefonos. Esto permite al Data- 
GridView conocer los metadatos (constructores, métodos, campos, propiedades y 
eventos) del tipo CTelefonosBO de los elementos de la colección sin tener que es- 
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perar a que los datos reales estén presentes para construir las columnas, situación 
que se produce durante el diseño (pruebe a comentar la línea siguiente y observará 
cómo durante el diseño no se muestran las columnas de la rejilla). 


this.colCTelefonosBindingSource.DataSource = typeof(ColCTelefonos); 


Finalmente, personalice la rejilla según lo enunciado: quite la columna Modi- 
ficado, establezca los títulos de las columnas, sus anchos, etc. 


Forml.cs Forml.cs [Diseño] + X 














H colCTelefonosBindingSource 


Lógica de interacción con la capa de presentación 


Según lo expuesto hasta ahora, para que la ventana de nuestra aplicación muestre 
en el DataGridView los datos de la tabla telefonos de la base de datos 
bd telefonos, tendremos que seleccionar dichos datos, almacenarlos en una colec- 
ción y establecer dicha colección, por medio de colCTelefonosBindingSource, 
como origen de datos de la rejilla. Esta operación la podemos realizar como res- 
puesta al evento Load de la ventana principal, según se indica a continuación: 


namespace ComponentesAccesoDatos 
{ 
public partial class Forml : Form 
{ 
private CTelefonoBLL bd = new CTelefonoBLL(); 
private ColCTelefonos colTfnos; 
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public Forml1() 
( 
InitializeComponent(); 


) 


private void Forml_lLoad(object sender, EventArgs e) 
( 
try 
( 
// Origen de datos 
coTfnos = bd.ObtenerFilasTfnos(); 
colCTelefonosBindingSource.DataSource = colTfnos; 
) 
catch (System.Exception ex) 
( 
MessageBox.Show(ex.Message):; 


) 


Obsérvese que la clase Form] define dos atributos: bd, objeto de la clase 
CTelefonoBLL cuya interfaz proporciona los métodos para el acceso a la capa de 
acceso a datos, y coTfnos, colección de objetos CTelefonoBO que se corresponde- 
rán con las filas de la tabla telefonos. Esta colección será obtenida invocando al 
método ObtenerFilasTfnos de bd antes de que se haya presentado la ventana 
Forml y será establecida como origen de datos del BindingSource. De esta for- 
ma, el DataGridView podrá establecer un enlace con dicha colección, lo que 
permitirá a sus columnas establecer un enlace con las propiedades a mostrar de los 
objetos CTelefonoBO de la colección, según se indica a continuación: 


this.nombreDataGridViewTextBoxColumn.DataPropertyName = "Nombre"; 
this.telefonoDataGridViewTextBoxColumn.DataPropertyName = "Telefono"; 
this.direccionDataGridViewTextBoxColumn.DataPropertyName = "Direccion"; 
this.observacionesDataGridViewTextBoxColumn.DataPropertyName = "Observaciones" ; 


Si echa una ojeada al código que se generó cuando configuró el Data- 
GridView observará, según muestra el código anterior, que cada una de las co- 
lumnas de la rejilla está vinculada con la propiedad del origen de datos que se 
desea mostrar a través de su propiedad DataPropertyName. 


Ejecute ahora la aplicación y pruebe a modificar, añadir y borrar filas; obser- 
vará que todo funciona como esperaba. Después observe la propiedad Modificado 
de los objetos CTelefonoBO de la colección coTfnos; su valor será true para los 
objetos añadidos y modificados, información necesaria para actualizar la base de 
datos en un instante determinado, por ejemplo, al cerrar la aplicación. 
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Pero, ¿qué pasa con los objetos borrados? Cada vez que eliminamos una fila 
del DataGridView se elimina el objeto CTelefonoBO correspondiente de la 
colección coTfnos. Pues bien, podemos eliminar simultáneamente la fila corres- 
pondiente de la tabla telefonos. Para ello, vamos a añadir a la ventana Forml el 
controlador del evento UserDeletingRow del DataGridView: 


private void dglelefonos_UserDeletingRow(object sender, _ 
DataGridViewRowCancelEventArgs e) 
( 
DataGridView dg = sender as DataGridView; 
if (dg.Rows.Count == 0) return; 
bd.BorrarFilaTfnos(e.Row.Cells[1].Value.ToString()); 
) 


Obsérvese que la columna 1 es la columna telefonoDataGridViewTextBoxCo- 
lumn. 


Y, ¿cuándo actualizamos la tabla telefonos de la base de datos con el resto de 
las filas modificadas? Podemos hacerlo cuando se vaya a cerrar la ventana, esto 
es, como respuesta al evento Closing de Form1. Según lo expuesto, añada el mé- 
todo que responde a este evento y complételo como se indica a continuación: 


private void Forml_FormClosing(object sender, FormClosingEventArgs e) 
( 
for (int i = 0; i < colfnos.Count; i++) 
{ 
if (coTfnos[i].Modificado) 
{ 
// Insertar 
if (bd.ObtenerFilaTfnosí(coTfnos[i].Telefono) == null) 
bd.InsertarFilaTfnos(coTfnos[i]); 
// Actualizar 
else 
bd.ActualizarNomDirO0bs(coTfnos[i]); 








Ahora bien, después de ejecutarse el método anterior, podremos observar que 
cuando se modifica el número de teléfono de una fila, esa fila aparece en la base 
de datos con el número antiguo y con el número nuevo. Lógico, cuando modifi- 
camos el número de teléfono, la colección de objetos CTelefonoBO queda actuali- 
zada y esa fila figurará como modificada, pero la base de datos seguirá 
conservando la fila con el teléfono antiguo. Este caso lo podemos solucionar bo- 
rrando de la base de datos la fila con el teléfono antiguo justo a continuación de 
haberla modificado, lo que nos exigirá conservar el teléfono antiguo en alguna va- 
riable, por ejemplo en un atributo tfmmoAntesDeModificar de Forml. Para ello, 
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añada a la clase Formlel atributo privado tfnoAntesDeModificar. El valor para es- 
te atributo lo obtendremos de la propia celda que estamos modificando justo 
cuando comience la edición. Para ello, simplemente tenemos que controlar el 
evento CellBeginE dit así: 


private void dglelefonos_CellBeginEdit(object sender, _ 
DataGridViewCellCancelEventArgs e) 
( 
DataGridView dg = sender as DataGridView; 
if (dg.CurrentCell.Value == null) return; 
if (e.Columindex == 1) 
tfnoAntesDeModificar = dg.CurrentCell.Value.ToString(); 


El nuevo valor introducido en la celda lo podemos obtener cuando la edición 
de la misma finalice, para lo cual controlaremos el evento CellEndEdit. Este con- 
trolador verificará que el número de teléfono se modificó, en cuyo caso eliminará 
de la base de datos la fila con el teléfono antiguo: 


private void dglelefonos_CellEndEdit(object sender, _ 
DataGridViewCellEventArgs e) 
( 
DataGridView dg = sender as DataGridView; 
if (tfnoAntesDeModificar == null) return; 
if (tfnoAntesDeModificar != dg.CurrentCell.Value.ToString()) 
{ 
if (bd.ObtenerFilaTfnos(tfnoAntesDeModificar) != null) 
bd.BorrarFilaTfnos(tfnoAntesDeModificar); 











) 
tfnoAntesDeModificar = null; 


Desacoplar la IU del resto de la aplicación 


Si nos fijamos en el código correspondiente a la lógica de interacción con la capa 
de presentación, observamos que ahí se controlan eventos expuestos por el Data- 
GridView con el fin de determinar qué operación hay que realizar en función de 
las operaciones que se realicen sobre la IU (interfaz de usuario). Sin embargo, al 
hacerlo de esta forma, estamos escribiendo código que es especifico de la rejilla; 
esto es, ¿qué pasaría si decidimos cambiar la interfaz de usuario para que ahora 
presente una lista y un número de cajas de texto para mostrar los detalles del ele- 
mento seleccionado de la lista? Pues que tendríamos que volver a escribir esta ló- 
gica y, quizás, los eventos del DataGridView no puedan satisfacer todas nuestras 
necesidades; por ejemplo, porque dispongamos de eventos “BeginEdit”, pero no 
“EndEdit”, por lo que los datos visibles a los controladores de eventos no estarán 
en su estado esperado. Un enfoque mejor sería si pudiéramos adaptar nuestra co- 
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lección de objetos CTelefonoBO de tal manera que pudiera ser asociada a cual- 
quier IU Windows Forms adecuada, con las operaciones de editar, añadir o elimi- 
nar sincronizadas con la base de datos a través del resto de la lógica de negocio. 


Con el fin de ilustrar lo que acabamos de exponer, vamos a realizar otra ver- 
sión de la aplicación anterior que recoja este nuevo enfoque. 


Adaptar la colección de objetos 


Vamos a añadir a la colección de objetos ColCTelefonos, derivada de Binding- 
List<CTelefonoBO>, la funcionalidad necesaria para que pueda informar a la 
aplicación de cuándo se inicia la edición de un objeto y cuándo finaliza la misma, 
para lo cual será necesario que cada objeto, a su vez, informe de estos hechos a su 
colección. 


Lo expuesto se puede hacer de una forma sencilla si los objetos de la colec- 
ción implementan la interfaz System.ComponentModel.IEditableObject: 


namespace ComponentesAccesoDatos 
( 


class CTelefonoB0 : INotifyPropertyChanged, TEditable0bject 


( 
IE aies 
void IEditable0bject.BeginEdit() 
( 


1 
f 


void IEditable0bject.CancelEdit() 
{ 


1 
J 


void IEditable0bject.EndEdit() 
{ 


1 
J 


La interfaz IEditableObject proporciona tres métodos que permiten confir- 
mar o deshacer los cambios realizados en un objeto que se utiliza como origen de 
datos: 


e BeginEdit. Este método se ejecuta cuando comienza la edición en un objeto. 


e CancelEdit. Este otro método permite descartar los cambios (tecla Esc) que 
se han realizado desde la última llamada a BeginEdit. 
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e  EndEdit. Y este otro método aplica los cambios realizados desde la última 
llamada a BeginEdit. 


Según lo expuesto, vamos a hacer que el método BeginEdit genere un evento 
ItemBeginEdit cuando comience la edición de un objeto CTelefonoBO y que End- 
Edit genere otro evento IltemEndEdit cuando finalice la edición. De esta forma, la 
colección podrá interceptar estos eventos e informarse de lo que ocurrió. Para 
ello, añada a la clase CTelefonoBO el código especificado a continuación: 


namespace ComponentesAccesoDatos 
( 
public delegate void ItemEditEventHandler(IEditable0bject sender); 


class ClelefonoBO : INotifyPropertyChanged, IEditable0bject 
( 
/1 


// Eventos ItemBeginEdit e ItemEndEdit 
public event ItemEditEventHandler ItemBeginEdit; 
public event ItemEditEventHandler ItemEndEdit; 


// Miembros de la interfaz IEditable0bject 

void IEditable0bject.BeginEdit() 

( 
if (ItemBeginEdit != null) 
( 





ItemBeginEdit(this); // generar evento 
) 
) 


void IEditable0bject.CancelEdit() 
( 
) 


void IEditable0bject.EndEdit() 
( 
if (ItemEndEdit != null) 
( 
ItemEndEdit(this); // generar evento 
) 


Observe que ambos eventos son del tipo definido por el delegado ltemEditE- 
ventHandler. Los métodos BeginEdit y EndEdit generan el evento correspon- 
diente adjuntando como información el objeto que está siendo editado. 
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Para que la colección de objetos CTelefonoBO pueda notificar a la aplicación 
que un determinado objeto está siendo editado, lo que tiene que hacer es capturar 
los eventos generados por ese objeto y generar eventos análogos por cada uno de 
ellos. Según esto, complete la clase colección ColCTelefonos como se indica a 
continuación: 


namespace ComponentesAccesoDatos 
{ 
class ColCTelefonos : BindingList<CTelefonoB0> 
( 
// Eventos ItemBeginEdit e ItemEndEdit de la colección 
public event ItemEditEventHandler ItemBeginEdit:; 
public event ItemEditEventHandler ItemEndEdit:; 


protected override void Insertltem(int ind, ClTelefonoBO item) 
( 





// Insertar un elemento en la posición especificada 
base.Insertltemíind, item); 
// Asignar un controlador para los eventos ItemBeginEdit e 
// ItemEndEdit de cada item CTelefonoBO de la colección 
item.ItemBeginEdit += 
new ItemEditEventHandler(ControladorltemBeginEdit):; 
d 
As 





item.ItemEndE 
new ItemEdi 





EventHandler(ControladorltemEndEdit):; 
) 











private void ControladorltemBegintdit(IEditable0Object sender) 
( 
// Generar el evento ItemBeginEdit de la colección por cada 
// evento ItemBeginEdit generado por un item CTelefonoBO 
if (ItemBeginEdit != null) 
( 








ItemBeginEdit(sender); 
) 
) 


private void ControladorltemEndEdit(IEditable0bject sender) 
( 

// Generar el evento ItemEndEdit de la colección por cada 

// evento ItemEndEdit generado por un item CTelefonoBO 

if (ItemEndEdit != null) 

( 

ItemEndEdit(sender); 
) 
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Observamos que la clase define dos eventos ltemBeginEdit e ltemEndEdit que 
se generarán cada vez que un objeto CTelefonoBO de la misma sea editado (el que 
los eventos de ColCTelefonos se llamen igual que los de CTelefonoBO es sim- 
plemente porque las acciones son las mismas; puede cambiarlos de nombre si lo 
desea). Para ello, hemos redefinido el método Insertltem heredado de Binding- 
List con el fin de asignar a los eventos ltemBeginEdit e ltemEndEdit de cada ob- 
jeto de la colección los controladores que deben ejecutarse cuando se genere cada 
uno de ellos. El método Insertltem es invocado automáticamente cada vez que se 
inserta un elemento en la colección, en este caso, como consecuencia de insertarlo 
en el DataGridView. 


Según lo expuesto, el controlador ControladorltemBeginEdit generará un 
evento ltemBeginEdit cuando comience la edición de un objeto CTelefonoBO y 
ControladorltemEndEdit generará otro evento ltemEndEdit cuando finalice la 
edición. De esta forma, la aplicación podrá interceptar estos eventos allí donde de- 
fina una colección, según veremos a continuación, eventos que, según dijimos, ad- 
juntan como información el objeto que está siendo editado. 


Finalmente, para cancelar la edición iniciada en una fila, restaurando los valo- 
res iniciales, y para asegurar que una operación de edición se ejecutará una sola 
vez (no dos veces consecutivas como ocurre con esta versión del DataGridView) 
modifique los métodos como se indica a continuación: 


// Copia para cuando se cancele la operación de edición 
private ClelefonoBO0 copia; 
private bool enEdicion = false; 


// Miembros de la interfaz IEditableO0bject 
void IEditable0bject.BeginEdit() 
( 

if (enEdicion) return; 

enEdicion = true; 


copia = this.MemberwiseClone() as ClelefonoBO; 


if (ItemBeginEdit != null) 
( 
ItemBeginEdit(this); // generar evento 
) 
) 


void IEditable0bject.CancelEdit() 
( 
if (lenEdicion) return; 
enEdicion = false; 
this.Nombre = copia.Nombre; 
this.Direccion = copia.Direccion; 
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this.Telefono = copia.Telefono; 
this.Observaciones = copia.Observaciones; 
this.Modificado = copia.Modificado; 


void IEditable0bject.EndEdit() 





if (lenEdicion) return; 
enEdicion = false; 
copia = null; 





if (ItemEndEdit != null) 
( 





ItemEndEdit(this); // generar evento 
) 
) 


Capa de lógica de negocio 


Esta capa, formada por la clase CTelefonoBLL, contiene la misma interfaz pública 
que su clase análoga en la capa de acceso a datos. Pero, en esta nueva versión de 
la aplicación, el método ObtenerFilasTfnos, además de obtener la colección de 
objetos CTelefonoBO, asignará a los eventos ltemBeginEdit, ItemEndEdit y List- 
Changed de la colección los controladores que deben ejecutarse cuando se genere 
cada uno de ellos: 


using System.Collections.Specialized; 
using System.ComponentModel'; 


namespace ComponentesAccesoDatos 
( 
class ClelefonoBLL 
( 
private CTelefonoDAL bd = new CTelefonoDAL(); 


public CTelefonoBO ObtenerFilaTfnos(string tfno) 
( 

return bd.ObtenerFilalfnos(tfno); 
) 


public ColCTelefonos ObtenerFilasTfnos() 
( 
ColCTelefonos colTfnos = bd.ObtenerFilasTfnos(); 
coTfnos.ListChanged += 
new ListChangedEventHandler(ControladorListChanged); 
// Asignar un controlador para los eventos ItemBeginEdit e 
// ItemEndEdit del objeto colección colfnos 
coTfnos.ItemEndEdit += 
new ItemEditEventHandler(ControladorltemEndEdit); 
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) 


colTfnos.ItemBeginEdit += 
new ItemEditEventHandler(ControladorltemBeginEdit); 


return colTfnos 


, 


private void ControladorListChanged(object sender, 
ListChangedEventArgs e) 


( 
) 


private void ControladorltemBeginEdit(IEditable0Object sender) 


( 
) 


private void ControladorltemEndEdit(IEditable0bject sender) 


pu 
st 


blic void Act 
ing tfnoAntig 


bd.Actualizar 


blic void Act 











bd.Actualizar 


a 


(0) 


a 


0 





blic string InsertarFilaTfnos(CTelefonoBO bo) 


eturn bd.InsertarFilalfnosíbo):; 


blic void BorrarFilaTfnosístring tfno) 


bd.BorrarFilaTfnos(tfno):; 


lizarNomDirTfn0bs(CTelefonoBO bo, 
uo) 


DirTfnObs(bo, tfnoAntiguo); 


lizarNomDir0bs(CTelefonoBO bo) 


DirO0bs(bo):; 


El evento ListChanged de BindingList se produce cuando se agrega, quita, 
cambia, mueve un elemento o se actualiza la lista completa. Observe el método 
que controla este evento, tiene un segundo parámetro que proporciona, entre otras, 


las siguientes propiedades: 


e  ListChangedType. Acción que provocó el evento: 
o  ItemAdded. Se agregó un elemento. 
o  ItemDeleted. Se quitó un elemento. 
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o  ItemChanged. Se modificó un elemento. 
o  ItemMoved. Se movió un elemento dentro de la colección. 
o Reset. El contenido de la colección ha cambiado significativamente. 
e NewlIndex. Obtiene el índice del elemento al que afecta el cambio. 
e  OldIndex. Obtiene el índice anterior de un elemento cuando este, debido a la 
operación realizada, se ha desplazado; en otro caso, el valor es —1. 


Entonces, cuando la acción sea ItemDeleted, eliminaremos el elemento de la 
base de datos invocando al método BorrarFilaTfnos y cuando la acción sea Item- 
Added, asignaremos a los atributos del objeto CTelefonoBO añadido unos datos 
genéricos predeterminados para evitar que se queden vacios. Según lo expuesto, 
implementaremos el controlador del evento ListChanged como se indica a conti- 
nuación: 


private void ControladorlListChanged(object sender, 
ListChangedEventArgs e) 
( 
if (e.ListChangedlype == ListChangedlype.ItemDeleted) 
BorrarFilalTfnos(tfnoAnterior); 
else if (e.ListChangedlype == ListChangedlype.ItemAdded) 
( 
if (e.OldIndex == -1) 
( 
CTelefonoBO obj = (sender as ColCTelefonos)[e.NewIndex]'; 
obj.Nombre = "nombre"; 
obj.Direccion = "dirección"; 
obj.Telefono = "000000000"; 
obj.Observaciones = "Ninguna"; 





Añada el atributo privado tfnoAnterior a la clase CTelefonoBLL. El valor para 
este atributo lo obtendremos del objeto CTelefonoBO cuya edición se inicia, obje- 
to que nos proporciona el evento /temBeginEdit de la colección. Esto es, tfnoAnte- 
rior hace referencia al teléfono justo cuando se inicia una operación de 
modificación, inserción o borrado. Según esto, añada al controlador Controladorl- 
temBeginEdit el código indicado a continuación: 


private void ControladorltemBeginEdit(IEditableO0bject sender) 
( 
tfnoAnterior = (sender as ClelefonoBO).Telefono; 


} 


Una vez implementadas las operaciones de añadir y borrar, nos queda la ope- 
ración de modificar. Según vimos en la versión anterior, para el caso en el que el 
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usuario modifique el número de teléfono de una fila del DataGridView, sabemos 
que la colección de objetos CTelefonoBO queda actualizada, pero la base de datos 
sigue conservando la fila con el teléfono antiguo, por lo que habrá que borrarla; 
esta operación no habrá que hacerla cuando las modificaciones no afecten al nú- 
mero de teléfono. 


Sabemos que cuando finalice la edición del objeto CTelefonoBO actual, la co- 
lección informará de ello generando el evento ItemEndEdit proporcionando el ob- 
jeto modificado. Por lo tanto, la respuesta a este evento será borrar de la base de 
datos la fila que tenga por número de teléfono tfmoAnterior e insertar una nueva 
fila, la correspondiente al objeto CTelefonoBO modificado. En el caso de que la 
modificación realizada sobre el objeto CTelefonoBO no afecte al número de telé- 
fono, simplemente actualizaremos la fila correspondiente de la base de datos. Se- 
gún esto, escriba el controlador del evento /temEndEdit de la colección como se 
indica a continuación: 


private void ControladorltemEndEdit(IEditableObject sender) 
( 

CTelefonoB0 obj = sender as ClelefonoBO; 

if (obj.Modificado == false) return; 


if (ObtenerFilalfnos(obj.Telefono) == null) 
( 
if (ObtenerFilalfnos(tfnoAnterior) != null) 
( 





BorrarFilalTfnos(tfnoAnterior); 
) 
InsertarFilaTfnos(obj):; 








) 
else 
( 
ActualizarNomDir0bs(obj):; 
) 
) 


Puede ser que el usuario inicie la edición de una fila y la abandone sin realizar 
ninguna modificación. En este caso, la propiedad Modificado del objeto seguirá 
valiendo false, dato que aprovecharemos para salir de ControladorltemEndEdit. 


Lógica de interacción con la capa de presentación 


Si nos fijamos en el código correspondiente a la capa de lógica de negocio, obser- 
vamos que ahí se controlan todos los eventos generados por la colección de obje- 
tos CTelefonoBO, resultado de las operaciones que el usuario realiza en la interfaz 
gráfica, con el fin de determinar qué operación hay que ejecutar sobre la base de 
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datos. Este código no es específico de la interfaz gráfica, por lo tanto, si decidi- 
mos cambiar la IU esta lógica de negocio no se verá afectada. 


Ahora, para que la ventana de nuestra aplicación muestre en el Data- 
GridView los datos de la tabla telefonos de la base de datos bd telefonos, ten- 
dremos simplemente que asignar la colección de objetos CTelefonoBO al contexto 
de datos del DataGridView. Esta operación la vamos a realizar en el controlador 
del evento Load de la ventana principal, según se indica a continuación; y esto es 
todo: 


namespace ComponentesAccesoDatos 
( 
public partial class Forml : Form 
( 
private CTelefonoBLL bd = new ClTelefonoBLL(); 
private ColCTelefonos colTfnos; 


public Forml1() 
( 
InitializeComponent(); 


) 


private void Forml_Load(object sender, EventArgs e) 
( 
try 
( 
// Origen de datos 
coTfnos = bd.ObtenerFilasTfnos(); 
colCTelefonosBindingSource.DataSource = coTfnos; 
) 
catch (System.Exception ex) 
( 
MessageBox.Show(ex.Message); 


) 


Como resumen, la arquitectura de la aplicación ha quedado así: 
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« 


Form1 
Clase 








+ Form 
CTelefonoBLL y | ColCTelefonos y CTelefonoBO y ItemEditEventH... Y | 
Clase Clase Clase Delegado 


+ BindingList<CTelefon.., 


CTelefonoDAL y 
Clase 








Validación 


Los datos que introducimos en un control DataGridView pueden ser validados 
individualmente a nivel de celda, o bien a nivel de fila. A nivel de celda, se vali- 
dan las propiedades individuales del objeto de datos enlazado, y a nivel de fila se 
valida el objeto de datos completo. Para más detalles, véase el apartado Datos in- 
troducidos por el usuario del capítulo Enlace de datos en Windows Forms. 


ACCESO DESCONECTADO A UNA BASE DE DATOS 


En este apartado se aborda el acceso desconectado a datos: las caracteristicas de 
ADO.NET que giran en torno a la clase DataSet y que permiten interactuar con 
los datos después de haber cerrado la conexión con el origen de datos. La clase 
DataSet es una alternativa a los componentes de acceso a datos que hemos creado 
en el apartado anterior para acceder a los datos de una base de datos, además de 
proporcionar flexibilidad para navegar, filtrar y clasificar datos. 


Un objeto de la clase DataSet representa un conjunto completo de datos (que 
incluye las tablas que contienen, ordenan y restringen los datos, así como las rela- 
ciones entre las tablas) residente en memoria que proporciona un modelo de pro- 
gramación relacional coherente independientemente del origen de los datos que 
contiene. Esto se traduce en que una aplicación, cuando se conecte a una base de 
datos, llenará el DataSet con la información extraída de la base de datos, para 
después manipular esos datos. Los cambios que a continuación se realicen en el 
DataSet no se verán reflejados en las tablas correspondientes de la base de datos. 
Para reflejarlos, la aplicación tendrá que conectarse de nuevo a la base de datos y 
aplicar sobre la misma todos los cambios realizados en el DataSet. Por supuesto, 
esta comodidad no está exenta de inconvenientes tales como problemas de concu- 
rrencia. Dependiendo de cómo esté la aplicación diseñada, un solo error en el 
momento de aplicar los cambios (por ejemplo, tratando de actualizar un registro 
que otro usuario actualizó mientras tanto) puede desbaratar el proceso de actuali- 
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zación. Evidentemente, una codificación estudiada puede proteger a la aplicación 
de estos problemas, pero, lógicamente, requiere un esfuerzo adicional. 


Según lo expuesto, la base para implementar un acceso desconectado es la 
clase DataSet. Esta clase ya fue expuesta anteriormente en este mismo capítulo. 
Si recuerda, un objeto de esta clase está compuesto por una colección de cero o 
más tablas y por otra colección de cero o más relaciones entre las tablas. Allí tam- 
bién se expuso la clase DataAdapter; un objeto de esta clase es necesario para 
extraer los registros de la base de datos y llenar con ellos el DataSet. Cada pro- 
veedor de datos proporciona su adaptador de datos; por ejemplo, SQL Server pro- 
porciona el adaptador SqlDataAdapter. Este adaptador actúa como puente entre 
la base de datos y el DataSet y contiene todas las órdenes SQL necesarias para 
consultar y modificar la base de datos. 


De la clase DataSet destacamos los métodos siguientes: 


e Clear. Borra cualquier dato del DataSet quitando todas las filas de todas las 
tablas. 


e Copy. Copia la estructura y los datos de un objeto DataSet, 


e Clone. Copia la estructura de DataSet, incluidos todos los esquemas, relacio- 
nes y restricciones de DataTable. No copia ningún dato. 


e Merge(DataSet). Combina el objeto DataSet especificado y su esquema en 
el objeto DataSet actual. 


Y de la clase DataAdapter destacamos los métodos siguientes: 


e Fill. Agrega filas a los objetos DataTable del DataSet ejecutando la consulta 
SelectCommand correspondiente. Si los objetos DataTable todavía no exis- 
ten, se crean. Si la conexión con la base de datos está cerrada antes de llamar 
a Fill, este método la abre para recuperar datos y, a continuación, la cierra; y 
si está abierta, permanece abierta. 


e  FillSchema. Agrega un DataTable al DataSet especificado y configura el 
esquema para hacerlo coincidir con el del origen de datos en función del tipo 
SchemaType especificado. No agrega ningún dato al DataTable. 


e Update. Examina todos los cambios en el DataTable y llama a las instruc- 
ciones INSERT, UPDATE o DELETE respectivas para cada uno de ellos con 
el fin de actualizar el origen de datos. 
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Como ejemplo, vamos a realizar la misma aplicación que realizamos en el 
apartado Acceso conectado a una base de datos, pero utilizando ahora los objetos 
DataSet y SqlDataAdapter en lugar de un objeto SqlDataReader. Ahora, el ori- 
gen de los datos para la lista será el DataSet. La lista mostrará los nombres de la 
tabla telefonos y un diálogo mostrará el teléfono de la persona seleccionada. 





a| e| 2 











sI Acceso desconectado 





Ismael Puertas López A 


Manuel Setien Laton 
Leticia Aguime 
Sonia Febril Pi 








942232323 




















Igual que en la versión anterior de esta aplicación, las operaciones de abrir la 
conexión con la base de datos y añadir a la lista las filas del conjunto de datos ob- 
tenido de la consulta a la base de datos serán ejecutadas desde el controlador del 
evento Click del botón “Mostrar datos”. En este caso, para realizar la consulta ne- 
cesitamos crear un objeto SqlDataAdapter y configurarlo para que su propiedad 
SelectCommand referencie la orden SQL que deseamos ejecutar: 


SqlDataAdapter da = new SqlDataAdapter(); 
da.SelectCommand = OrdenSql; 


También hay que crear el objeto DataSet que almacenará el resultado de la 
consulta, que será realizada por el método Fill de SqlDataAdapter pasando como 
argumento el DataSet. Este objeto almacena el resultado en una tabla (objeto Da- 
taTable), en la especificada como segundo argumento (si no se especifica se utili- 
za un nombre genérico: Table, Tablel, Table2..., o el especificado por la 
propiedad TableMappings del DataAdapter): 


DataSet ds = new DataSet(); 
da.Fill(ds, "telefonos”); 


Cuando ya tenemos el objeto DataSet con los datos de la consulta, estable- 
cemos que la tabla almacenada en el mismo sea el origen de datos del ListBox. 
Este control tiene que mostrar el campo nombre de la fila actualmente selecciona- 
da de la tabla y guardar como valor el campo telefono de dicha fila. Para ello, hay 
que asignar a su propiedad DataSource el origen de datos, esto es, la tabla telefo- 
nos del DataSet; a su propiedad DisplayMember, el dato a mostrar, esto es, el 


CAPÍTULO 13: ACCESO A UNA BASE DE DATOS 569 


campo nombre del origen de datos; y a su propiedad ValueMember, el valor a 
utilizar cuando se seleccione un elemento de la lista, esto es, el campo telefono: 





IsTfnos.DisplayMember = "nombre"; 
IsTfnos.ValueMember = "telefono"; 
lsTfnos.DataSource = ds.Tables["telefonos"]; 


Según lo expuesto, modifique el controlador del botón “Mostrar datos” como 
se indica a continuación: 


private void btMostrarDatos_Click(object sender, EventArgs e) 
{ 
using (ConexionConBD) 
{ 
// Crear una consulta 
string Consulta = "SELECT nombre, telefono FROM telefonos”; 
OrdenSql = new SqlCommand(Consulta, ConexionConBD); 
// Abrir la conexión con la base de datos 
ConexionConBD.Open(); 
// Crear y configurar un objeto SqlDataAdapter 
SqlDataAdapter da = new SqlDataAdapter(); 
da.SelectCommand = OrdenSql; 
// Crear un DataSet y llenarlo con el resultado de la consulta 
DataSet ds = new DataSet(); 
da.Fill(ds, "telefonos"); 
// Configurar el ListBox para que muestre los datos 
IsTfnos.DisplayMember = "nombre"; 
IsTfnos.ValueMember = "telefono"; 
|sTfnos.DataSource = ds.Tables["telefonos”]; 
) 
btMostrarDatos.Enabled = false; 
) 





Finalmente, edite el controlador del evento SelectedIndexChanged de la lista 
para que muestre el teléfono de la persona seleccionada. Este valor lo proporciona el 
campo referenciado por la propiedad ValueMember de la lista, al que se accede 
por medio de la propiedad SelectedValue de la misma: 


private void IsTfnos_SelectedIndexChanged(object sender, EventArgs e) 
( 
if (IsTfnos.Selectedindex < 0) return; 
MessageBox.Show(1sTfnos.SelectedValue.ToString()); 
) 


Más adelante veremos cómo modificar los datos del conjunto de datos y cómo 
actualizar la base de datos. 
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ASISTENTES DE VISUAL STUDIO 


En el ejemplo anterior se han creado los distintos objetos del proveedor de datos 
de forma manual antes de interactuar con la base de datos relacional, pero debe- 
mos saber que Visual Studio pone a nuestra disposición varios asistentes para 
ayudarnos en el diseño de una aplicación. Por lo tanto, la tarea siguiente es anali- 
zar cómo se utilizan estos asistentes que pueden escribir por nosotros una gran 
cantidad de código en aplicaciones que requieren acceso de datos. 


Una aplicación que interaccione con una base de datos, generalmente, mostra- 
rá los datos en uno o más formularios, permitirá manipularlos y, finalmente, ac- 
tualizará la base de datos. El ejemplo que vamos a realizar a continuación 
presentará un formulario Windows que mostrará los datos obtenidos de una base 
de datos en una rejilla, control DataGridView. La rejilla la configuraremos para 
que sea editable, lo que permitirá realizar cambios en los datos y actualizar la base 
de datos con los mismos. 


La base de datos que vamos a utilizar para este ejemplo es bd” telefonos.maf, 
la misma base de datos SQL Server que hemos utilizado en los ejemplos anterio- 
res. Utilizar otros gestores de bases de datos como Access u Oracle no cambia el 
procedimiento a seguir. 


El desarrollo de esta aplicación lo vamos a dividir en los siguientes pasos: 


p< 


Crear la base de datos SQL Server si aún no está creada. 

2. Crear una aplicación Windows utilizando Visual Studio. 

3. Crear la conexión necesaria para acceder a la base de datos y crear una con- 
sulta que permita obtener los datos de la misma. 

4. Crear el conjunto de datos. 

5. Agregar un control DataGridView al formulario y enlazarlo con el conjunto 
de datos. 

6. Escribir el código necesario para llenar el conjunto de datos y para enviar los 

cambios que efectúe el usuario de vuelta a la base de datos. 


De lo expuesto se deduce que el origen de datos de la rejilla es el conjunto de 
datos, objeto DataSet, que la rejilla muestra estos datos, que el usuario puede in- 
teractuar con la rejilla para modificar, insertar o borrar datos, que dichos cambios 
se reflejarán automáticamente en el conjunto de datos vinculado con la rejilla y 
que esos cambios serán enviados por la aplicación a la base de datos cuando lo 
decidamos, por ejemplo, al cerrar el formulario. 


A diferencia de la versión anterior de esta aplicación, ahora, los componentes 
del proveedor de acceso a datos que necesitemos utilizar los obtendremos de la 
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caja de herramientas de Visual Studio. Si estos componentes no estuvieran en la 
caja de herramientas, añádalos. Para ello, seleccione en el Cuadro de herramien- 
tas el panel en el que quiere añadir los componentes y, después, utilizando el bo- 
tón secundario del ratón, haga clic en su barra de título y ejecute la orden Elegir 
elementos... del menú contextual que se visualiza. 





Cuadro de herramientas Formi.cs [Diseño] + X 





Búsqueda en el Cuadro de herramie P~- ; 
b Todos los Windows Forms a Form1 lo JE Es] 
b Controles comunes 


b Contenedores 
p Generación de informes 
b Menús y barras de herramientas 


k Puntero i 
Chart Vista de lista 
e” BindingNavigator Mostrar todos 


3 BindingSource 
fi DataGridView 
Y DataSet 


Elegir elementos.. 


Ordenar le alfabéticamente 


Restablecer cuadro de herramientas 
b Componentes 


p Impresión Agregar pestaña 

b Cuadros de diálogo Eliminar pestaña 

b Interoperabilidad WPF Cambiar nombre de pestaña 
b Visual Basic PowerPacks Subir 

b General Bajar 








Para este ejemplo, en la ventana que se visualiza, seleccione los componentes 
SqlCommand, Sql/CommandBuilder, SqlConnection y SqlDataAdapter. 


Continuando con el ejemplo, cree una nueva aplicación que muestre un for- 
mulario vacío en el diseñador. Para ello, ejecute la orden Archivo > Nuevo > Pro- 
yecto. Después, elija como plantilla Aplicación de Windows Forms. Asigne un 
nombre al proyecto, por ejemplo ComponentesADO.NET. Ya tenemos el proyecto 
creado y el diseñador visualiza un formulario. A continuación, vamos a construir 
la siguiente arquitectura (la base de datos ya está construida: es bd_ telefonos.mdf, 
en la carpeta Cap131 Componentes ADO.NET del CD que acompaña al libro puede 
ver el ejercicio completo): 
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Conjunto Proveedor de acceso a datos 
de datos 
DataAdapter 









Connection 





Crear la infraestructura para el acceso a la base de datos 


Para empezar, añada a la aplicación un adaptador de datos que contenga la ins- 
trucción SQL que se utilizará más adelante para llenar el conjunto de datos que 
mostrará la rejilla. Para ello, arrastre desde el panel Datos del Cuadro de herra- 
mientas un componente SqlDataA dapter sobre el formulario. 


4 Datos 
k Puntero 
Chart 
w BindingNavigator 


J  BindingSource 

e: DataGridView 

a DataSet 

e SqlCommand 

ST SqiCommandBuilder 
ES SqlConnection 









SqlDataAdapter 





Dent SqlDataAdapter 


Versión 4.0.0.0 de Microsoft Corporation 
.NET Component 





p Impresión 






b Cuadros de diálogo 
b Interoperabilidad WPF 
b Visual Basic PowerPacks 





b General 


La acción anterior arrancará el Asistente para la configuración del adaptador 
de datos. Haga clic en el botón Nueva conexión: 


r 
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Agregar conexión Le ee) 





Especifique la información para establecer conexión con el origen de datos 
seleccionado o haga clic en "Cambiar" para elegir un origen y/o un 
proveedor de datos diferente. 


Origen de datos: 
Microsoft SQL Server (SqlClient) Cambiar... 
Nombre del servidor: 


Asqlexpress si Actualizar 


Conexión con el servidor 


(9) Usar autenticación de Windows 


© Usar autenticación de SQL Server 


Guardar mi contraseña 


Establecer conexión con una base de datos 


®© Seleccione o escriba el nombre de la base de datos: 


bd_telefonos X 


5 Asociar con un archivo de base de datos: 


Avanzadas... 








== 

















En la ventana que se visualiza, elija como origen de datos Microsoft SQL Ser- 
ver, como nombre del servidor .\sqlexpress y seleccione el nombre de la base de 
datos de la lista correspondiente; en nuestro caso, bd_ telefonos; después, haga clic 
en el botón Probar conexión y si el test resultó satisfactorio, haga clic en Aceptar. 
Ahora, en la ventana del asistente, puede observar la nueva conexión y, si quiere, 
la cadena de conexión. Haga clic en Siguiente para pasar al siguiente paso: elegir 
el modo de acceso del adaptador a la base de datos; elija “Usar instrucciones 


SQL” y 


que nos 


después haga clic en Siguiente. 


En el siguiente paso, el asistente nos ayudará a generar las instrucciones SQL 
permitirán consultar, insertar, borrar y modificar los datos de la base de 
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f 
Asistente para la configuración del adaptador de datos == 
Generar las instrucciones SQL =} 


La instrucción SELECT se utilizará para crear las instrucciones 
INSERT, UPDATE y DELETE. 


Escriba su instrucción SQL o utilice el Generador de consultas para construirlo. ¿Qué 
datos se deben cargar en la tabla? 


¿Qué datos debería cargar el adaptador en el conjunto de datos? 








Generador de consultas... | 
<hnerar | Sover T 























Haga clic en el botón Opciones avanzadas y, en la ventana que se visualiza, 
seleccione Generar instrucciones Insert, Update y Delete para que se generen, a 
partir de la instrucción SQL SELECT que construiremos a continuación, las ins- 
trucciones SQL INSERT, UPDATE y DELETE para el adaptador de datos. Si el 
adaptador se va a utilizar solo para leer datos de la base de datos y no para actua- 
lizarlos, puede dejar esta casilla de verificación sin marcar. 


Cuando sea necesario, esta tarea puede ser realizada durante la ejecución por 
medio del objeto SqlCommandBuilder, según vimos anteriormente. 





fr 
Opciones avanza A + 

















Se pueden generar instrucciones adicionales Insert, Update y Delete para actualizar el origen de 
datos. 


v| Generar instrucciones Insert, Update y Delete 





Genera instrucciones Insert, Update y Delete basadas en la instrucción Select. 
Y] Usar simultaneidad optimista 











Modifica instrucciones Update y Delete para detectar si la base de datos ha cambiado desde 
que se cargó el registro en el conjunto de datos. Esto ayuda a prevenir conflictos de 
simultaneidad. 

[Y] Actualizar el conjunto de datos 
Agrega una instrucción Select después de instrucciones Insert y Update para recuperar 
valores de columnas de identidad, valores predeterminados y otros valores calculados por la 


base de datos. 














La lógica empleada en el código que ejecutará las instrucciones UPDATE y 
DELETE contra la base de datos se basa en la simultaneidad optimista, lo cual 
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quiere decir que, en la base de datos, los registros no se bloquean para ser editados 
y pueden ser modificados en cualquier momento por otros usuarios o procesos. 
Por lo tanto, existe la posibilidad de que un registro sea modificado después de 
que haya sido devuelto por la instrucción SELECT y antes de que se emita una 
instrucción UPDATE o DELETE. Por ello, la instrucción UPDATE o DELETE 
generada incluirá una cláusula WHERE que especificará que la fila solo será ac- 
tualizada cuando contenga todos sus valores originales y no haya sido eliminada 
del origen de datos, lo cual evita que se sobrescriban los datos nuevos. Cuando se 
dé este caso, la instrucción no tendrá ningún efecto en los registros de la base de 
datos y se lanzará una excepción DBConcurrencyException. Si no se desea este 
comportamiento, habrá que generar estas instrucciones manualmente y asignárse- 
las a las propiedades correspondientes del adaptador de datos. 


Y la opción Actualizar el conjunto de datos hace que el asistente genere códi- 
go que vuelva a leer un registro de la base de datos después de actualizarlo. Esta 
operación proporcionará una vista actualizada. 


Siguiendo con el desarrollo de la aplicación, haga clic en el botón Generador 
de consultas y, según la propuesta realizada, agregue la tabla telefonos sobre la 
que deseamos realizar la consulta. Después, seleccione todas las columnas de la 
tabla telefonos y ejecute la consulta si quiere observar el resultado. 


a 9) y ll 
Generador de consultas o 











lm] > 


telefonos E] 


[]* (Todas las columnas) 





[*]nombre 
[Y] direccion 
[M] telefono 
[YJobservaciones 





« |m r 


Columna Alias Tabla Resul.. Tipo de orden Criterio de or.. ^ 

> nombre == telefonos Y Z 
direccion. s] telefonos Y 
telefono telefonos V 
v 


observaciones telefonos 


4 mo n + 


SELECT nombre, direccion, telefono, observaciones 
FROM telefonos 


nombre direccion telefono observaciones 





> Francisco Ceballos Fernández. Boston, U.S.A. 111555999 CEO Evermedia y 
1 de14 |» bl 5 





Ejecutar consulta Aceptar J| Cancelar 
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Si el resultado de la consulta programada es el deseado, haga clic en Aceptar 
y después en Siguiente. El asistente le mostrará las tareas realizadas: 


r 





Asistente para la configuración del adaptador de datos 





Resultados del asistente 


Revise la lista de tareas que ha realizado el asistente. Haga clic en 
Finalizar para completarlo o en Anterior para realizar cambios. 





El adaptador de datos "sqlDataAdapter1" se configuró correctamente. 


Detalles: 


Y Instrucción SELECT generada. 





Y Instrucción INSERT generada. 
Y Instrucción UPDATE generada. 
Y Instrucción DELETE generada. 
Y Asignaciones de tabla generadas. 


Para aplicar esta configuración al adaptador, haga clic en Finalizar. 





È) 











Haga clic en Finalizar para completar el proceso o en Anterior para realizar 
cambios. En nuestro caso hacemos clic en Finalizar para volver al diseñador de 
Visual Studio: 











A fi 
w sqlDataAdapter1 Ss sqlConnectioni 


Observe la figura anterior; corresponde al diseñador de Visual Studio; en su 
parte inferior (en la bandeja) se pueden observar dos objetos: sq/DataAdapterl y 
sqlConnectionl. Esto significa que el asistente ha creado un adaptador de datos 
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que contiene la consulta (además de las otras instrucciones SQL) que se utilizará 
para llenar el conjunto de datos y, como parte de este proceso, ha definido una 
conexión para obtener acceso a la base de datos. Por lo tanto, el proveedor de da- 
tos está construido. El paso siguiente es crear el conjunto de datos que almacenará 
los datos obtenidos de la base de datos por medio del proveedor de datos. 


Nota: el asistente para la configuración del adaptador de datos también puede 
mostrarse a través de la lista de tareas programadas del adaptador sq!DataAdap- 
ter] que puede ver en la figura anterior (clic en el botón H). 


Crear el conjunto de datos 


El conjunto de datos que hay que generar es un objeto de la clase DataSet. Una 
forma sencilla de generar automáticamente este conjunto de datos basado en la 
consulta que se ha especificado para el adaptador de datos es utilizando, de nuevo, 
los asistentes de Visual Studio. Para ello, ejecute la orden Generar conjunto de 
datos de la lista de tareas programadas del adaptador sq/DataAdapterl (clic en el 
botón P). Se mostrará el cuadro de diálogo de la figura siguiente: 


r = 
Generar conjunto de datos (0 ea 


Generar un conjunto de datos que incluya las tablas especificadas. 








Elija un conjunto de datos: 
Existente: 
9) Nuevo: DataSetl 


Elija las tablas que desea agregar al conjunto de datos: 





[Y] telefonos (sqlDataAdapterl) 





Y] Agregar este conjunto de datos al diseñador. 


pa > 























Ponga nombre a la clase que dará lugar al conjunto de datos y elija las tablas 
que desea agregar al mismo; en nuestro caso solo hay una: telefonos. Asegúrese 
de que la casilla Agregar este conjunto de datos al diseñador está marcada. Des- 
pués, haga clic en Aceptar. Visual Studio generará un conjunto de datos denomi- 
nado, en este caso, dataSetl 1 de la clase DataSet!. 
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Agregar un control rejilla al formulario 


Arrastre desde el panel Datos del cuadro de herramientas un control Data- 
GridView, una rejilla, sobre el formulario. Observe que la rejilla añadida tiene 
habilitadas las operaciones insertar, modificar y borrar filas (registros). 





-g ia] 















Elegir origen de datos: 
Editar columnas... 
Agregar columna... 
Habilitar acción de agregar 
Habilitar edición 


Habilitar eliminación 





Habilitar reordenación de columnas 


= Acoplar en contenedor primario 





A continuación, vincule esta rejilla, dataGridView1, con la tabla telefonos del 
conjunto de datos. Para ello, asigne a su propiedad DataSource el valor dataSetl 1 
(véase la figura siguiente) y a su propiedad DataMember la tabla telefonos de ese 
conjunto de datos. 





dataGridViewl System.Windows.Forms.DataGridVie ~ 


amas + 


DataMember 2 


aSource (ninguno) [z] 
[9 Ninguno! 
4 E Otros orígenes de datos 
a 8 Orígenes de datos del proyectd 
> g DataSetl 
a Él Forml instancias de listas 


J EE 


ImeModd , i y 
Location 
Locked 














*a Agregar origen de datos del 


Al seleccionar una instancia de listas 
Editar colur de formularios se enlaza directament... 














Finalmente, ajuste el tamaño de la rejilla para que se puedan ver todas las co- 
lumnas y varias filas. Para que la rejilla varíe su tamaño acorde al tamaño del 
formulario, fije su propiedad Anchor con los valores Top, Bottom, Left y Right, y 
su propiedad AutoSizeColumnsMode con el valor Fill. También, desde el menú 
de tareas, puede editar las cabeceras de las columnas. 
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Código subyacente 


El siguiente paso es añadir el código necesario para llenar la rejilla con los datos 
del conjunto de datos. Para ello, si se encuentra en la página de diseño, seleccione 
el formulario; después, diríjase a la ventana de propiedades y haga clic en el botón 
Eventos de su barra de herramientas. Seleccione el evento Load que se producirá 
justo cuando se cargue el formulario y haga doble clic sobre Load; esto hará que 
se añada el controlador Form1_Load de este evento; complételo como se muestra 
a continuación: 


private void Forml_Load(object sender, EventArgs e) 
( 
dataSet11.Clear(); 
sqlDataAdapter1.Fill(dataSet11); 


1 
j 


El método anterior, primero borra el conjunto de datos actual y, a continua- 
ción, llama al método Fill del adaptador de datos, pasándole de nuevo ese conjun- 
to de datos para volverlo a llenar con el resultado de la consulta realizada. 


Si ahora ejecutamos la aplicación, el resultado será similar al siguiente: 









r 














nombre direccion telefono observacione 
Ismael Puertas López Mataró, Ba... | 934343567 |Frabicante ... 
Miguel López Trujillo Mataporqu... | 942232323 | Es propieta.. 
Manuel Setien Latorre Santander,... | 942555333 | Ninguna 

Leticia Aguirre Soriano Triana, Se... (954345678 | Ninguna 

Sonia Febril Parra Valdeoliva... | 958565656 | Ninguna 
Carmen Torres Saldaña Motril, Gra... (958737373 | Ninguna [2 
Bena Veiguela Suarez Muxía, La... 981425323 | Ninguna 1 
Ana María Cuesta Suñer Gijón, Astu... | 984454545 | Ninguna 




















El método Fill recupera filas del origen de datos mediante la sentencia SE- 
LECT especificada por la propiedad SelectCommand del adaptador de datos. Si 
la conexión está cerrada antes de llamar a Fill, esta se abrirá para recuperar datos 
y, a continuación, se cerrará. Si la conexión está abierta antes de llamar a Fill, esta 
permanecerá abierta. 


Las filas recuperadas por Fill se vuelcan en la tabla telefonos de dataSetl 1. Si 
no se especifica el nombre de la tabla del DataSet (como segundo argumento de 
Fill), como es el caso, se asumirá el valor especificado por la propiedad Table- 
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Mappings del DataAdapter, que generalmente es el mismo que tiene la tabla en 
el origen de datos. 


Sólo nos queda añadir el código para actualizar la base de datos con las modi- 
ficaciones que se realicen sobre la rejilla. 


Cuando el usuario de la aplicación haga un cambio en una fila de la rejilla de 
datos, dicho cambio será reflejado automáticamente en el registro correspondiente 
del conjunto de datos (esto sucede justo en el momento de cambiar el punto de in- 
serción a otra fila), pero no en la base de datos. Esto tiene que hacerlo explícita- 
mente el adaptador de datos invocando a su método Update, que examina cada 
registro de la tabla de datos especificada del conjunto de datos y, si se ha modifi- 
cado alguno, ejecuta las órdenes apropiadas del adaptador referenciadas por sus 
propiedades InsertCommand, UpdateCommand o DeleteCommand. Obsérve- 
se también que la rejilla tiene activadas las propiedades AllowUserToAddRows y 
AllowUserToDeleteRows. 


Según lo expuesto, agregue un nuevo controlador al formulario, en este caso 
para manipular el evento FormClosing que se produce cuando se cierra el mismo. 
Después, complete dicho controlador así: 


private void Forml_FormClosing(object sender, FormClosingEventArgs e) 
if (dataSet11.HasChanges()) 
sqlDataAdapterl.Update(dataSet11); 
MessageBox.Show("0Origen de datos actualizado"); 
) 


El método anterior primero pregunta si hubo cambios (método HasChanges), 
y en caso afirmativo llama al método Update del adaptador de datos, pasándole el 
conjunto de datos que contiene las actualizaciones que se desea realizar sobre la 
base de datos, y después invoca al método Show del objeto MessageBox para 
mostrar un mensaje de confirmación. 


Lo que en realidad ocurre es que las filas (objetos DataRow del objeto Data- 
Table del DataSet) añadidas a la tabla del conjunto de datos son marcadas a tra- 
vés de su propiedad RowState con el valor Added; las actualizadas, con el valor 
Modified; y las borradas, con el valor Deleted. De esta forma, Update podrá 
identificarlas y ejecutar así la instrucción InsertCommand, UpdateCommand o 
Delete Command adecuada para cada caso. 
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Una alternativa a la rejilla de datos, que exponemos un poco más adelante, es 
utilizar controles individuales, como cajas de texto, para mostrar un registro cada 
vez. Este nuevo diseño requiere agregar botones de desplazamiento al formulario. 


Un ejercicio interesante que puede realizar ahora es analizar el código que ha 
sido generado por los asistentes para implementar esta aplicación y que ha sido 
añadido a los ficheros DataSetl.Designer.cs, que define la clase que da lugar al 
conjunto de datos, Form1.Designer.cs, que define la clase que da lugar al formu- 
lario. De esta forma, tomará conciencia del código que sería necesario escribir si 
quisiera realizar la aplicación sin utilizar los asistentes de Visual Studio. 


Comparativamente, DataSetl.Designer.cs define los componentes de datos 
que nosotros creamos de forma personalizada anteriormente en el apartado Cons- 
truir componentes de acceso a datos. 


Asistente para configurar orígenes de datos 


En los apartados anteriores hemos visto diferentes alternativas para crear la capa 
de acceso a datos que nos permite abstraernos de las operaciones con la base de 
datos. En este apartado vamos a exponer una alternativa más; el resultado será si- 
milar al obtenido en el apartado anterior cuando añadimos la clase DataSet] que 
dio lugar al objeto dataSet11, esto es, la capa que vamos a crear tendrá también 
como base un DataSet. Esta nueva alternativa nos permitirá conocer cómo añadir 
esta capa de acceso a datos de forma explícita, la cual proporcionará las clases ne- 
cesarlas para crear un adaptador, un conjunto de datos, una tabla, una fila de la ta- 
bla, etc., clases que serán generadas automáticamente por el Asistente para la 
configuración de orígenes de datos (en la carpeta Cap13lLogicaAccesoDatos del 
CD que acompaña al libro puede ver el ejercicio completo). 


Cuando finalice este apartado, se dará cuenta de que los conceptos aquí ex- 
puestos ya fueron estudiados, de otra forma, en el capítulo Enlace de datos en 
Windows Forms. 


Como ejercicio, cree una aplicación Windows denominada, por ejemplo, Lo- 
gicaAccesoDatos. A continuación construimos la capa de acceso a datos que dará 
lugar al origen de datos de la aplicación. Para ello, Visual Studio proporciona un 
asistente que podemos ejecutar seleccionando la opción Agregar nuevo origen de 
datos, bien desde el menú Proyecto del entorno de desarrollo, o bien desde la ven- 
tana Orígenes de datos que podemos visualizar seleccionando la opción Ver > 
Otras ventanas > Orígenes de datos. El asistente mostrado le permitirá crear un 
conjunto de datos (DataSet) a partir de una base de datos. Para crear este conjunto 
de datos elija en las sucesivas ventanas que va mostrando el asistente, la informa- 
ción siguiente: 


582 ENCICLOPEDIA DE MICROSOFT VISUAL C# 


Tipo de origen de datos: Base de datos. 

Modelo de base de datos: Conjunto de datos. 

Conexión para conectarse a la base de datos: bd_telefonos.maf. 
Objetos de base de datos: tabla telefonos. 

Nombre del DataSet: dsTelefonos. 





G 


Asistente para la configuración de orígenes de datos 





F- Elija los objetos de base de datos 


¿Qué objetos de la base de datos desea tener en el conjunto de datos? 
-Ele Tablas 

: B-RA telefonos 

HB Vistas 

S-E El Procedimientos almacenados 

fx Funciones 





















































Nombre de DataSet: 


dsTelefonos 





Siguie Finalizar | Cancelar 

















Cuando haga clic en el botón Finalizar habrá creado la clase que define el 
conjunto de datos. Si ahora, desde Visual Studio, ejecuta la orden Datos > Mos- 
trar orígenes de datos, podrá observar en el panel Orígenes de datos la estructura 
de este origen de datos: 





Orígenes de datos 


CE ER ES 
4 ¡gi dsTelefonos 
- EI 
nombre 
direccion 
telefono 
observaciones 
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Así mismo, si hace clic con el botón secundario del ratón sobre el nombre del 
DataSet y ejecuta la orden Editar DataSet con el diseñador del menú contextual 
que se visualiza, se mostrará la siguiente ventana: 


CUE Lae- Form1.cs [Diseño] 


nombre 
direccion 
telefono 
observaciones 





t Fill GetData () 


La figura anterior muestra dos elementos: telefonos, de la clase DataTable, y 
telefonosTableAdapter, de la clase TableAdapter. El primero hace referencia a la 
tabla del DataSet y el segundo al adaptador que se utilizará para, ejecutando la 
orden SQL SELECT, llenar la tabla del DataSet. Esto es lo que anteriormente de- 
nominamos “acceso desconectado a base de datos”. El adaptador presenta dos mé- 
todos: Fill y GetData. El método Fill toma como parámetro un DataTable o un 
DataSet y ejecuta la orden SQL programada (puede verla haciendo clic con el bo- 
tón secundario del ratón en el título de cualquiera de los dos elementos y ejecu- 
tando la orden Configurar del menú contextual que se visualiza). El método 
GetData devuelve un nuevo objeto DataTable con los resultados de la orden 
SQL. También se han creado los métodos Insert, Update y Delete que se pueden 
llamar para enviar los cambios realizados en filas individuales directamente a la 
base de datos. 


Así mismo, en la vista de clases del entorno de desarrollo puede ver la fun- 
cionalidad proporcionada por la clase del conjunto de datos añadido, dsTelefonos, 
funcionalidad que utilizaremos cuando sea necesario. Esta clase anida otras clases 
y, además de la clase del conjunto de datos, se definen también otras clases; por 
ejemplo, la clase telefonosTableAdapter (véase la figura siguiente) que permitirá 
crear un adaptador que a través de su método Fill o GetData facilitará el acceso a 
la tabla telefonos para obtener los datos de dicha tabla. 
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MER EREE v AX 
i O a -|% 
<Búsqueda> - AP 


4 LogicaAccesoDatos 
> El Referencias del proyecto 
b () LogicaAccesoDatos 
4 () LogicaAccesoDatos.dsTelefonosTableAdapters 
> fg TableAdapterManager 
b ^ TableAdapterManager.SelfReferenceComparer 
bp * TableAdapterManager.UpdateOrderOption 


E telefonosTableAdapter 


p () LogicaAccesoDatos.Properties 


© Delete(string, string, string, string) a 

© FilllLogicaAccesoDatos.dsTelefonos.telefonosDataTable) 

© GetData() 

O, InitAdapter() 

O, InitCommandCollection( 

%, InitConnection() 

O Insert(string, string, string, string) = 
4 » 
Explorador de soluciones Vista de clases Vista de recursos 


Para mostrar los datos de la tabla telefonos de la base de datos, puede proce- 
der de alguna de las dos formas indicadas a continuación: 


1. Arrastre desde el panel Orígenes de datos la tabla telefonos del conjunto de 
datos dsTelefonos. 


2. Arrastre desde el panel Datos del cuadro de herramientas un control Data- 
GridView. A continuación, abra el menú de tareas de la rejilla y configúrela, 
asignando, como primer paso, el origen de datos. 


Quizás, la forma más sencilla sea la primera (la segunda fue la que vimos en 
el apartado anterior). Para hacer lo indicado en ese punto 1, diríjase al panel Ori- 
genes de datos y arrastre sobre el formulario la tabla telefonos del conjunto de da- 
tos dsTelefonos. Observando la figura siguiente, vemos a la izquierda de la 
entidad telefonos un icono: DataGridView, Detalles, etc. (refresque la vista si es 
necesario haciendo clic en el botón Refrescar de la barra de herramientas de este 
panel). 
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Orígenes de datos "Ax 
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4 ¡gi dsTelefonos 


- AI] 
[SE] DataGridView 
O] Detalles 


© [Ninguno] 








ls 


Personalizar... 





El icono al que nos hemos referido en el párrafo anterior, seleccionable ha- 
ciendo clic con el ratón en el botón situado a la derecha de la entidad, indica el 
control o controles que se añadirán sobre el formulario para acceder al origen de 
datos. Nosotros vamos a dejar el seleccionado, DataGridView, para que se añada 
una rejilla. Una vez añadida, fije su propiedad Anchor con los valores Top, Bot- 
tom, Left y Right, y su propiedad AutoSizeColumnsMode con el valor Fill. 


La operación descrita añadirá al formulario Form] un conjunto de datos 
dsTelefonos, de tipo dsTelefonos, un adaptador telefonosTableAdapter para llenar 
la tabla de dsTelefonos y un control telefonosBindingNavigator de la clase Bin- 
dingNavigator que tiene por origen de datos (propiedad BindingSource) al com- 
ponente telefonosBindingSource de la clase BindingSource, que, a su vez, está 
conectado al origen de datos dsTelefonos. Si la barra de navegación no se necesi- 
ta, podrá ocultarla poniendo su propiedad Visible a false. 


También se añade un objeto de la clase TableAdapterManager que propor- 
ciona funcionalidad para guardar datos en tablas de datos relacionadas; para ello, 
usa las relaciones de clave externa que relacionan las tablas de datos para deter- 
minar el orden correcto para enviar las inserciones, actualizaciones y eliminacio- 
nes de un conjunto de datos a la base de datos sin infringir las restricciones 
FOREIGN KEY (integridad referencial) en la base de datos; son estas restriccio- 
nes las que evitan que se eliminen los registros primarios mientras permanecen los 
registros secundarios relacionados en otra tabla: actualización jerárquica. 


VISTA EN DETALLE DEL CONJUNTO DE DATOS 


El enlace de datos es un proceso que establece una conexión entre la interfaz grá- 
fica del usuario (IGU) de la aplicación y la lógica de negocio, para que cuando los 
datos cambien su valor, los elementos de la IGU que estén enlazados a ellos refle- 
jen los cambios automáticamente y viceversa. Este proceso de transportar los da- 
tos adelante y atrás fue estudiado con detalle en el capítulo Enlace de datos en 
Windows Forms. Pues bien, a continuación vamos a estudiar con un ejemplo có- 
mo aplicarlo cuando el origen de datos es una base de datos. 


586 ENCICLOPEDIA DE MICROSOFT VISUAL C# 


ADO.NET proporciona varias estructuras de datos adecuadas para el enlace: 
DataColumn, DataTable, DataView, DataSet y DataViewManager. 


Un objeto DataColumn tiene una propiedad DataType que determina el tipo 
de datos que contiene la columna; por ejemplo, el nombre de la tabla telefonos de 
la base de datos bd_ telefonos. Enlazar un control a una columna de una tabla de 
datos es una operación sencilla; por ejemplo, el siguiente código enlaza la propie- 
dad Text de la caja de texto c£Nombre a la columna nombre de la tabla telefonos: 


ctNombre.DataBindings.Add(new Binding("Text", telefonos, "nombre", true)); 


Y el ejemplo siguiente muestra cómo enlazar un DataGridView a una tabla: 


dataGridViewl.DataSource = tablalTfnos; 


Un objeto DataTable es la representación de una tabla, según estudiamos an- 
teriormente, y contiene dos colecciones referenciadas por sus propiedades Co- 
lumns, que representa las columnas de la tabla, y Rows, que representa las filas. 


Cuando establezca un enlace con un objeto DataTable, en realidad estará es- 
tableciendo un enlace a la vista predeterminada de la tabla. Precisamente, la pro- 
piedad DefaultView de la tabla devuelve el objeto DataView predeterminado 
para la tabla: una vista personalizada que se puede filtrar u ordenar. Por lo tanto, 
también es posible establecer enlaces sencillos o complejos directamente con un 
objeto DataView. Por ejemplo: 


dataGridViewl.DataSource = tablalfnos.DefaultView; 


Un DataSet es una colección de tablas, relaciones y restricciones de los datos 
de una base de datos. Cuando establecemos enlaces sencillos o complejos a los 
datos dentro de un conjunto de datos, en realidad estamos estableciendo el enlace 
al DataViewManager predeterminado del DataSet. 


Un DataViewManager es una vista personalizada de un DataSet, análogo a 
DataView, pero con relaciones incluidas, y por medio de su propiedad Data- 
ViewSettings (colección de objetos DataViewSetting, características de ordena- 
ción y filtrado, para cada DataTable de un DataSet) podemos establecer filtros 
predeterminados y opciones de ordenación para cualquier vista que Data- 
ViewManager tenga para una tabla determinada. Por ejemplo: 


DataViewManager dvm = new DataViewManager():; 
dvm.DataSet = dataSetll; 
dvm.DataViewSettings["telefonos"].Sort = "nombre"; 
dataGridViewl.DataSource = dvm; 
dataGridViewl.DataMember = "telefonos"; 
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La rejilla que hemos utilizado en las distintas versiones que hemos venido de- 
sarrollando para mostrar la tabla telefonos de la base de datos bd telefonos es un 
control vinculado a un conjunto de datos. Vamos a realizar una nueva versión de 
esa aplicación utilizando ahora varios controles para mostrar la tabla, uno para ca- 
da campo de la misma. Esto es, la aplicación reunirá fundamentalmente las si- 
guientes características: 


e  Visualizará en un formulario cada uno de los campos del registro selecciona- 
do, permitiendo modificar cualquiera de ellos. 


e Los campos nombre, direccion y telefono se visualizarán en cajas de texto, y 
el campo observaciones en una caja de texto multilínea. 


e Permitirá moverse de un registro a otro con el fin de visualizarlos o editarlos. 


Para empezar, cree una aplicación Windows ControlesEnlazadosADatos (en 
la carpeta Cap13|ControlesEnlazadosADatos del CD puede ver el ejercicio com- 
pleto). Después, configure un origen de datos eligiendo como modelo un conjunto 
de datos (DataSet) que permita acceder a la base de datos bd_telefonos.mdf. Para 
ello, ejecute la opción Agregar nuevo origen de datos del menú Proyecto y pro- 
porcione la información siguiente: 


Tipo de origen de datos: Base de datos. 

Modelo de base de datos: Conjunto de datos. 

Conexión para conectarse a la base de datos: bd" telefonos.mdf. 
Objetos de base de datos: tabla telefonos. 

Nombre del DataSet: dsTelefonos. 


Orígenes de datos ax 

CER E 

4 a dsTelefonos 

- tecon: EA 

nombre 
direccion 
telefono 
observaciones 





Diseño del formulario 


Añada al formulario los controles que muestra la figura siguiente y que se descri- 
ben a continuación. 
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Nombre 


Dirección: 


Teléfono 


Notas 














Objeto Propiedad 
Name Labell 

Caja de texto ame 
Label2 
Label3 


ext Notas: 
ame Label4 


ame ctNotas 
Multiline true 


Obsérvese que las etiquetas utilizadas hacen referencia a los campos de la ta- 
bla telefonos de la base de datos. 


| 


o 
E 
O 


Caja de texto 
Etiqueta 


o 
z 
O 


Caja de texto 
Etiqueta 


o 
E 
O 





ziz A ZIZ AZ ZAS 
z 
O 


Caja de texto 








Vincular las cajas de texto con el conjunto de datos 


Para enlazar los controles que van a visualizar los datos de cada registro de la ta- 
bla telefonos con los campos respectivos del conjunto de datos, siga estos pasos: 


1. Sitúese en el diseñador de formularios. 
2. Seleccione la caja de texto ctNombre y su propiedad DataBindings; expanda 


este nodo y vincule el campo nombre de la tabla telefonos del conjunto de da- 
tos dsTelefonos con la propiedad Text de ciNombre. 
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Propiedades Y AX 
ctNombre System.Windows.Forms.TextBox > 
anas  £ 
(ApplicationSettings) E 
E (DataBindings) 
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AcceptsR a a dsTelefonos 
AcceptsT a E telefonos J 
Accessibl A nombre 
Accessibl ğ don 3 
Accessibl E telefono 
AllowDro E observaciones 
Anchor |, | " + 











Esta operación añadirá a Form] un conjunto de datos dsTelefonos de tipo 
dsTelefonos, un adaptador telefonosTableAdapter para acceder a la tabla tele- 
fonos de la base de datos y un componente telefonosBindingSource de la clase 
BindingSource conectado al origen de datos dsTelefonos. 


Observe ahora el valor de la propiedad Text de c£Nombre. Tiene como origen 
de datos el campo nombre de telefonosBinding8ource de la clase Binding- 
Source. 


3. Repita el paso 2 para el resto de las cajas de texto, ctDireccion, ctTelefono y 
ctObservaciones. Después de estas operaciones, fíjese en que el origen de da- 
tos de los campos es telefonosBindingSource. 


La propiedad DataBindings de un control da acceso a la colección Control- 
BindingsCollection que permite almacenar los vínculos que mantiene ese control 
con los orígenes de datos desde los cuales quiere proveerse, lo que, a su vez, le 
permitirá interactuar de forma directa con ellos. Por ejemplo, cuando en el punto 2 
anterior establecimos un vínculo entre la propiedad Text de ctNombre y la co- 
lumna nombre de la tabla telefonos del DataSet, el asistente de Visual Studio 
añadió el siguiente código: 
this.ctNombre.DataBindings.Add( 


new System.Windows.Forms.Binding( 
"Text", this.telefonosBindingSource, "nombre", true)); 


que también puede escribir así: 


ctNombre.DataBindings.Add("Text", dsTelefonos, "telefonos.nombre"):; 
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Para más detalles vea el capítulo Enlace de datos en Windows Forms. 


Esta sentencia añade a la colección ControlBindingsCollection un enlace 
(objeto Binding) entre su propiedad Text y la columna nombre de la tabla telefo- 
nos del DataSet. Cualquier objeto que hereda de la clase Control puede tener 
acceso a esta colección mediante la propiedad DataBindings. 


Si a continuación ejecuta la aplicación, observará que se visualiza el primer 
registro de la base de datos. Esto es debido a que se ha añadido al formulario el 
método que responde a su evento Load para que rellene la tabla telefonos del con- 
junto de datos dsTelefonos al que indirectamente están vinculadas las cajas de tex- 
to que tienen que mostrar los datos almacenados en el mismo. No obstante, no 
dispone de ninguna forma para moverse de un registro a otro. 


private void Forml_Load(object sender, EventArgs e) 
( 

this.telefonosTableAdapter.Fill(this.dsTelefonos.telefonos); 
) 


Obsérvese que este método invoca al método Fill del adaptador telefonosTa- 
bleAdapter para llenar la tabla telefonos del conjunto de datos dsTelefonos. 


Controles de navegación 
Vamos a colocar cuatro botones que nos permitan navegar por la base de datos 
(Inicio, Anterior, Siguiente y Final), y una etiqueta para mostrar el registro (1, 2, 


3, 4...) que se está mostrando y el número total de registros. 


Las propiedades de estos controles se especifican en la tabla siguiente: 


Objeto Propiedad valor 

Botón de pulsación Text Primero 
Name btPrimero 

Botón de pulsación Text Anterior 
Name btAnterior 


Etiqueta Text No registros 


Name etPosicion 
TextAlign MiddleCenter 
BordersStyle Fixed3D 
AutoSize false 


Botón de pulsación Text Siguiente 
Name btSiguiente 
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Botón de pulsación Text Último 
Name btUltimo 


f< 
ul BD teléfonos Leal EI 


Nombre: 











Dirección: 


Teléfono 


Notas: 


Primero | Anterior No registros Último 

















Volviendo al desarrollo de la aplicación, cuando se llene el conjunto de datos 
el formulario mostrará en las cajas de texto los datos relativos al primer registro y 
la etiqueta etPosicion debe indicar “1 de n_regs”, siendo n_regs el total de regis- 
tros. Según esto, modifique el método Form] _ Load como se indica a continua- 
ción: 


private void Forml_Load(object sender, EventArgs e) 
( 
telefonosTableAdapter.Fill(dsTelefonos.telefonos); 
MostrarPosicion(); 
) 


En el método anterior se observa que después de llenar el conjunto de datos se 
invoca al método MostrarPosicion que calcula el número total de registros del 
conjunto de registros y la posición del registro que se está visualizando (el regis- 
tro 1 está en la posición 0) y, en función de estos datos, la etiqueta etPosicion 
mostrará el literal “reg_i de n_regs”. Añada este método a la clase Form]. 


private void MostrarPosicion() 
( 





// Total registros 
int iTotal = telefonosBindingSource.Count; 
// Número (1, 2, ...) de registro 
int Pos; 
if (iTotal == 0) 
etPosicion.Text = "No registros”; 
else 
( 
iPos = telefonosBindingSource.Position + 1; 





// Mostrar información en la etiqueta 
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etPosicion.Text = ¡Pos.ToString() + " de " + iTotal.ToString(); 
) 
) 


El objeto BindingSource hace de puente entre el control y el conjunto de da- 
tos, proporcionando acceso a los datos actualmente mostrados por el control de 
una forma indirecta, incluyendo navegación, ordenación, filtrado y actualización. 
Este objeto se encargará de sincronizar los cuatro controles para que juntos mues- 
tren el nombre, la dirección, el teléfono y las observaciones del registro que está 
en esa posición. 


La propiedad Position de BindingSource mantiene la posición del registro 
(fila de la tabla) actual; por lo tanto, para movernos por los registros de una tabla 
hay que utilizar esta propiedad. Así, para desplazarse al primer elemento hay que 
asignar a Position el valor cero, para desplazarse al final de la tabla hay que asig- 
nar a Position el valor de la propiedad Count menos uno, para ir al elemento si- 
guiente al actual hay que sumar a Position uno, y para ir al elemento anterior al 
actual hay que restar a Position uno. 


Según lo expuesto, para que cada botón de pulsación añadido al formulario 
realice la función indicada por su título, añada los controladores que responden a 
su evento Click y complételos como se indica a continuación: 


private void btPrimero_Click(object sender, EventArgs e) 

( 
telefonosBindingSource.Position = 0; 
MostrarPosicion():; 


} 


private void btAnterior_Click(object sender, EventArgs e) 

{ 
telefonosBindingSource.Position -= 1; 
MostrarPosicion(); 





} 


private void btSiguiente_Click(object sender, EventArgs e) 

{ 
telefonosBindingSource.Position += 1; 
MostrarPosicion(); 


} 


private void btUltimo_Click(object sender, EventArgs e) 
( 





telefonosBindingSource.Position = telefonosBindingSource.Count - 1; 
MostrarPosicion(); 








} 
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Si ahora ejecuta la aplicación, observará que puede moverse por todos los re- 
glstros de la base de datos y, por lo tanto, modificar cualquiera de ellos. Las modi- 
ficaciones realizadas sobre un registro tienen efecto solo si a continuación nos 
movemos a otro registro. 


Añadir, borrar y buscar datos 


Anteriormente hemos visto cómo movernos de un registro a otro de la base de da- 
tos y cómo mostrar en controles vinculados al conjunto de datos el registro ac- 
tualmente seleccionado, lo que permite modificar dicho registro, pero no tenemos 
ninguna forma de añadir, borrar o buscar registros. 


Con el objeto de poder realizar todas estas operaciones en la base de datos 


bd telefonos, vamos a añadir los botones que muestra la figura siguiente y que se 
describen a continuación: 


Botón de pulsación Text Añadir 

Botón de pulsación Text Borrar 

Etiqueta Buscar: 
Name Label5 
Name 
Text 
Name 


N 
N 
N 


N ctBuscar 
N btBuscar 


- 
a BD teléfonos Ll El s 
































Nombre Isabella Ceballos González Añadir 
Dirección Boston, U.S.A. Borrar 
Teléfono 123456789 Buscar: 

Notas La más grande Buscar 














Primero ] Anterior 2de 14 Último 
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Cuando el usuario pulse el botón de Añadir, se deberá añadir un nuevo regis- 
tro al conjunto de datos; lo añadiremos con unos datos genéricos para que las ca- 
jas no estén vacías. Una vez añadido, editaremos cada uno de sus campos y 
continuaremos con la siguiente operación. El origen de datos será actualizado con 
las modificaciones realizadas sobre el conjunto de datos cuando cerremos la apli- 
cación, como veremos un poco más adelante. El proceso descrito lo realizaremos 
desde el controlador del evento Click de este botón, cuyo código se muestra a 
continuación: 


private void btAñadir_Click(object sender, EventArgs e) 
( 

DataTable miTabla = dsTelefonos.telefonos; 

DataRowCollection cfilas = miTabla.Rows; 

DataRow nuevaFila; 

try 

( 

// Nueva fila 

evaFila = miTabla.NewRow()'; 
// Datos por omisión para las columnas de la nueva fila 


evaFilal0] = "Nombre"; // columna O 
evaFilal1] = "Dirección"; // columna 1 
evaFila[2] = "Teléfono"; // columna 2 
evaFila[3] = "Observaciones"; // columna 3 








cfilas.Add(nuevaFila); 
btUltimo.PerformClick(); //hacer clic en Último 
ostrarPosicion():; 

ctNombre.Focus(); // enfocar la caja de texto ctNombre 

















) 
catch (ConstraintException ex) 
( 
// Capturar posible error por clave duplicada (teléfono) 
MessageBox.Show(ex.Message); 
) 








} 


Para entender el código anterior, recuerde que, en nuestra aplicación, el con- 
junto de datos es el objeto ds Telefonos de la clase DataSet y que esta clase define 
la colección Tables de la clase DataTableCollection de objetos DataTable; en 
nuestro caso, incluye una sola tabla: telefonos. A su vez, la clase DataTable defi- 
ne, entre otras, la colección Rows de la clase DataRowCollection de objetos Da- 
taRow (filas de la tabla o registros). 


Observamos entonces que el método bt4Añadir_Click primero define miTabla, 
que hace referencia a la tabla telefonos; cfilas, que hace referencia a la colección 
de filas de la tabla anterior; y nuevaFila, para referenciar la nueva fila que desea- 
mos añadir a la colección de filas de la tabla. A continuación crea una nueva fila 
invocando al método NewRow de la tabla, asigna datos genéricos a cada una de 
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sus columnas y la añade a la colección cfilas invocando a su método Add. Dicha 
fila será añadida al final; para mostrarla y poder así editar cada una de sus colum- 
nas, btAñadir_Click invoca al método PerformClick del botón btUltimo, que es 
como si hubiéramos hecho clic sobre el botón “Último”. Finalmente, actualiza la 
caja de texto ctPosicion y sitúa el foco sobre la primera caja de texto, la del nom- 
bre, invocando a su método Focus. 


Obsérvese cómo accedemos al contenido de una columna; por ejemplo, de la 
columna Nombre, la que está en la posición 0 por ser la primera: 


nuevaFilal0] = "Nombre"; 


La sentencia anterior también podría escribirse de la forma siguiente: 


nuevaFila[l"nombre"] = "Nombre"; 


Para borrar el registro o fila que se esté visualizando, el usuario pulsará el bo- 
tón Borrar. Antes de borrarlo, se pedirá la conformidad del usuario. En caso afir- 
mativo, se invocará al método Delete de la fila. Lo que hace en realidad Delete es 
marcar la fila como borrada (la propiedad RowState de la fila es puesta al valor 
Deleted). La fila que se muestra es un objeto de la clase DataRowView, y es 
accesible a través de la propiedad Current del componente BindingSource, y la 
fila de la colección Rows de la tabla correspondiente al objeto DataRowView 
mostrado es accesible a través de la propiedad Row de este. Finalmente, se invoca 
al método MostrarPosicion para actualizar la caja de texto ctPosicion. Según lo 
expuesto, el controlador del evento Click del botón Borrar será así: 


private void btBorrar_Click(object sender, EventArgs e) 
( 

DataRowView vistaFilaActual; 

string NL = Environment.NewLine; 


if (MessageBox.Show("¿Desea borrar este registro?" + 
NL, "Buscar", MessageBoxButtons.YesNo, 
MessageBoxIcon.Question) == DialogResult.Yes) 
( 
vistaFilaActual = ((DataRowView)telefonosBindingSource.Current); 
vistaFilaActual.Row.Delete(); 
MostrarPosicion(); 
) 
) 


Finalmente, el botón Buscar permitirá al usuario buscar un registro determi- 
nado a partir del actual, utilizando el método Find de DataRowCollection o el 
método Select de DataTable y código SQL. El operador SQL Like permite hacer 
búsquedas de texto. Por lo tanto, lo utilizaremos para buscar la cadena deseada en 


596 ENCICLOPEDIA DE MICROSOFT VISUAL C# 


las filas del conjunto de datos. Según esto, escriba el controlador del evento Click 
del botón Buscar así: 


private void btBuscar_Click(object sender, EventArgs e) 


( 


DataTable miTabla = dsTelefonos.telefonos; 
DataRowCollection cfilas = miTabla.Rows; 
DataRow[] filaBuscada; // matriz de filas 
string NL = Environment.NewLine; 


// Buscar en la columna Nombre de cada fila 
string criterio = "Nombre Like **" + ctBuscar.Text + "**"; 








// Utilizar el método Select para encontrar todas las filas que 
// pasen el filtro y almacenarlas en la matriz filaBuscada 
filaBuscada = miTabla.Select(criterio):; 








if (filaBuscada.GetUpperBound(0) == -1) 

( 
MessageBox.Show("No se encontraron registros coincidentes", "Buscar"); 
return; 


) 


// Seleccionar de las filas encontradas la que buscamos 
int da JE 
for (i = 0; i <= filaBuscada.GetUpperBound(0); i++) 
( 
if (MessageBox.Show("¿Es este el nombre buscado?" + NL + 
(string)filaBuscada[li]["nombre"] + NL, "Buscar", 
MessageBoxButtons.YesNo) == DialogResult.Yes) 


// Si: mostrar en el formulario la fila seleccionada 

telefonosBindingSource.Position = 
cfilas.Index0f(filaBuscada[i]):; 

MostrarPosicion():; 

break; 





El método Select localiza y almacena en la matriz filaBuscada todas las filas 


que pasen el filtro de que el nombre contenga una subcadena igual a la especifica- 
da por criterio (observe que el filtro de búsqueda es '*subcadena*”, donde * indi- 
ca cualquier conjunto de caracteres). Por ejemplo, podríamos buscar “Pedro 
Aguado Rodríguez” por “Aguado”, por “agua”, etc. 


Finalmente, añadiremos el código para actualizar la base de datos con las mo- 


dificaciones que se hayan realizado. Para ello, agregue un nuevo controlador al 
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formulario, en este caso para manipular el evento FormClosing que se produce 
cuando se cierra dicho formulario. Después, complete dicho controlador así: 


private void Forml_FormClosingí(object sender, FormClosingEventArgs e) 
( 
if (dsTelefonos.HasChanges()) 
( 
telefonosTableAdapter.Update(dsTelefonos.telefonos); 
MessageBox.Show("0Origen de datos actualizado"); 
) 


CONTROL BindingNavigator 


La aplicación anterior permite navegar por los registros de la base de datos y, 
además, modificarlos, añadir nuevos registros, borrarlos, o buscar si existe o no 
un determinado registro. Pues bien, Visual Studio incluye también un control 
BindingNavigator que proporciona al usuario las operaciones de navegar (prime- 
ro, siguiente, anterior, último) por los registros de una base de datos, mostrar la 
posición del registro actual, el número total de registros, así como las operaciones 
de añadir y borrar un registro. El aspecto de este control sobre un formulario es el 
siguiente: 





a Formi Erim 


H 4 6 de24 |» bl F X W 





El control BindingNavigator está compuesto de un ToolStrip con los si- 
guientes objetos ToolStripxxx (ToolStripButton, ToolStripSeparator, etc.): 


Botón para ir al registro primero. 

Botón para ir al registro anterior. 

Caja de texto para mostrar la posición del registro actual. 
Etiqueta para mostrar el número total de registros. 

Botón para ir al registro siguiente. 

Botón para ir al último registro. 

Botón para añadir un registro. 

Botón para eliminar un registro. 


Cada uno de estos objetos es asignado a la propiedad correspondiente del con- 
trol BindingNavigator. Por ejemplo: 


private BindingNavigator bindingNavigatorl; 
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private ToolStripButton bindingNavigatorMoveFirstltem; 

private ToolStripTextBox bindingNavigatorPositionltem; 

/1 

bindingNavigatorl = new BindingNavigator(); 
bindingNavigatorMoveFirstItem = new ToolStripButton(); 
bindingNavigatorPositionItem = new ToolStripTextBox(); 

/1 

bindingNavigatorl.MoveFirstltem = bindingNavigatorMoveFirstItem; 
bindingNavigatorl.Positionltem = bindingNavigatorPositionItem; 








/1 


Para conectar este control con el origen de datos, simplemente hay que asig- 
nar a su propiedad BindingSource el componente BindingSource que tiene la 
conexión con ese origen de datos. Por ejemplo: 


telefonosBindingSource.DataMember = "telefonos"; 
telefonosBindingSource.DataSource = dsTelefonos; 


bindingNavigatorl.BindingSource = telefonosBindingSource; 


Si los botones proporcionados de forma predeterminada no encajan en la apli- 
cación en desarrollo, se pueden quitar, o si son necesarios botones adicionales, se 
podrán agregar más objetos ToolStripItem. 


Cada uno de los controles de BindingNavigator tiene su correspondiente 
propiedad o método en el componente BindingSource proporcionando la misma 
funcionalidad. Por ejemplo, el botón MoveFirstltem se corresponde con el método 
MoveFirst de BindingSource, la posición Positionltem se corresponde con la 
propiedad Position de BindingSource, etc. Según esto, la siguiente sentencia ha- 
ce que el registro actual sea el correspondiente a la posición n: 


bindingSourcel.Position = n; 


Si recuerda, ya vimos un ejemplo de utilización de este control en el apartado 
Ventana de orígenes de datos del capítulo Enlace de datos en Windows Forms. 


DISEÑO MAESTRO-DETALLE 


Un diseño de tipo maestro-detalle incluye dos partes: una vista que muestra una 
lista de elementos, normalmente una colección de datos, y una vista de detalles 
que muestra los detalles acerca del elemento que se selecciona en la lista anterior. 
Por ejemplo, este libro es un ejemplo de diseño de tipo maestro-detalle, donde la 
tabla de contenido es la vista que muestra una lista de elementos y el te- 
ma/apartado escrito es la vista de detalles. 
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Cuando queremos relacionar un conjunto de datos maestro con otro de deta- 
lles, una tabla actuará como maestra o tabla padre, y otra, como de detalles o tabla 
hija. Por ejemplo, pensemos en un conjunto de libros. Éstos pueden agruparse por 
temas. Evidentemente, un tema determinado, por ejemplo informática, incluirá ce- 
ro o más libros, y un libro pertenecerá a un tema determinado o a ninguno, si aún 
no se ha establecido. Pues bien, Visual C#/Visual Studio facilita el trabajo con ta- 
blas relacionadas de esta forma: padre-hija. 








temas titulos 
$ id_tema 8 id_libro 

tema titulo 
id_tema 




















Vamos a realizar un ejemplo sencillo que permita mostrar en la pantalla datos 
obtenidos de una base de datos que almacena títulos de libros agrupados por te- 
mas. Empecemos por crear una aplicación Windows para después crear la base de 
datos. Abra Visual Studio y ejecute Archivo > Nuevo > Proyecto. Se abrirá una 
caja de diálogo titulada Nuevo proyecto. Elija el tipo de proyecto Windows, la 
plantilla Aplicación de Windows Forms, asigne un nombre (por ejemplo, Maes- 
troDetalle) y una ubicación al proyecto y pulse el botón de Aceptar. 


Para crear una base de datos SOL Server en Visual Studio, lo más sencillo es 
utilizar el explorador de bases de datos (si está utilizando Visual Studio Express, 
lea el apartado Crear una base de datos del apéndice A). Esta utilidad nos permi- 
tirá añadir al proyecto una base de datos SOL Server, sus tablas, modificar el es- 
quema de una base de datos existente, introducir datos en las tablas de la base y 
examinar una base que ya esté construida. La base de datos que vamos a crear la 
denominaremos bd libros y estará formada por dos tablas: titulos y temas. Para 
ello, muestre la utilidad Explorador de bases de datos o Explorador de servidores 
desde el menú Ver, haga clic con el botón secundario del ratón en el nodo Cone- 
xiones de datos y seleccione la orden Crear una nueva base de datos..., del menú 
contextual. Se muestra el diálogo siguiente: 
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Introduzca el nombre del servidor y el nombre de la base de datos. Después, 





r 





Crear nueva base de datos de SQL Server 


ESP 





Introduzca la información necesaria para conectarse a SQL 
Server y, a continuación, especifique el nombre de la base de... 


Já Actualizar 


Nombre del servidor: 


Asqlexpress 
Conexión con el servidor 


(9) Usar autenticación de Windows 


© Usar autenticación de SQL Server 


Guardar mi contraseña 


Nombre de la base de datos nueva: 


bd_libros 

















haga clic en el botón Aceptar para continuar. 


Una vez que tenemos una conexión con la base de datos que acabamos de 
crear, lo siguiente es añadir las tablas a la base de datos. Vamos a crear dos tablas: 
titulos y temas. Para ello, diríjase al Explorador de bases de datos y haga clic con 
el botón secundario del ratón en el nodo Tablas del nodo bd libros y ejecute la 
orden Agregar nueva tabla del menú contextual que se visualiza. Se muestra el 
editor de tablas. Edite la tabla titulos como se muestra a continuación: 


dbo,titulos [Diseño]* + X Forml.cs 


% Actualizar 
Nombre 
o ¡d_libro 
titulo 


id_tema 


| |G Diseñar 


t 


Formi.cs [Diseño] 


Archivo de script: dbo.titulos.sql* > 








Tipo de datos Permitir valores NULL b Claves (1) 
int [E] Restricciones CHECK (0) 
nvarchar(80) Índices (0) 


DO 


int 





S T-SQL 


=CREATE TABLE [dbo].[titulos] ( 


[id_libro] INT 
[titulo] 
[id_tema] INT 


NOT NULL, 
NVARCHAR (80) NOT NULL, 
NOT NULL, 


PRIMARY KEY CLUSTERED ([id_libro] ASC) 


) 3 
100% ~ 
4 Conexión lista 


Claves externas (0) 
Desencadenadores (0) 


nam 


4 
+ 


a 


| Asqlexpress | fjceballos-PC\fjceballos | bd_libros 
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Obsérvese que id libro (identificador del libro) se ha establecido como clave 
principal. Cierre la tabla y póngale como nombre titulos. Siguiendo un proceso 
análogo, edite la tabla temas según se muestra a continuación: 


dbo.temas [Diseño] ® X Formi.cs [Diseño] X 





% Actualizar Archivo de script: dbo.temas.sql > 


Nombre Tipo de datos Permitir valoi Claves (1) 
SS) teme int E Restricciones CHECK (0) 
tema nvarchar(30) F] Indices (0) 


Claves externas (0) 
Desencadenadores (0) 


] 
| sl 











| G Diseñar tt S T-SQL | mamn 
CREATE TABLE [dbo].[temas] ( + 
[id_tema] INT NOT NULL, a 
[tema] NVARCHAR (30) NOT NULL, 
PRIMARY KEY CLUSTERED ([id_tema] ASC) 
100% + 
4 Conexión lista | Asqlexpress | fjceballos-PC\fjceballos | bd_libros 


Ya tenemos las dos tablas creadas. Para introducir datos en las mismas, haga 
clic con el botón secundario del ratón en cada una de ellas y seleccione la orden 
Mostrar datos de la tabla del menú contextual. 


Para que la aplicación pueda acceder a la base de datos, es necesario crear un 
conjunto de datos. Para ello, ejecute la orden Agregar nuevo origen de datos del 
menú Proyecto. Se mostrará el cuadro de diálogo de la figura siguiente: 





r = x 
Asistente para la configuración de orígenes de datos 1.0 is 





p- Elegir un tipo de origen de datos 


¿De dónde obtendrá la aplicación los datos? 


z :® w E] 


Base de datos Servicio Objeto SharePoint 




















Seleccione el tipo de la fuente de la que se obtendrán los datos, en nuestro ca- 
so elegiremos Base de datos; después, haga clic en Siguiente, elija Conjunto de 
datos como modelo de bases de datos, haga clic en Siguiente, y elija la conexión 
con la base de datos: 
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YT My 
Asistente para la configuración de orígenes de datos Le ea 





p- Elegir la conexión de datos 


¿Qué conexión de datos debería utilizar la aplicación para conectarse a la base de datos? 











[fceballos-pasqlexpress.bd,_libros.dbo z] | Nueva conexión... | 





En el siguiente paso elija los objetos de la base de datos con los que va a tra- 
bajar. En nuestro caso hacemos clic en el nodo Tablas para elegir ambas tablas 
para formar un conjunto de datos denominado dsTitulosTemas. 





r > 
Asistente para la configuración de orígenes de datos Lo esa 





F- Elija los objetos de base de datos 


¿Qué objetos de la base de datos desea tener en el conjunto de datos? 
2-1] Tablas 
E-MER temas 
MB id_tema 
B tema 
titulos 
B id_libro 
B titulo 
MB id_tema 
DEB vistas 
El Procedimientos almacenados 
Efx Funciones 


E 
ca lala 











Nombre de DataSet: 
dsTitulosTemas 





< Anterior Cancelar 























Cuando haga clic en Finalizar se añadirá a la aplicación el conjunto de datos 
dsTitulosTemas.xsd. Este objeto será el que utilicemos para mostrar los datos de la 
base de datos en la aplicación, para lo cual usaremos controles vinculados a los 
datos del conjunto de datos. Nuestra aplicación simplemente tiene que mostrar los 
libros y el tema correspondiente al libro seleccionado, y lo hará mediante una re- 
lación padre-hijo. Según este planteamiento, la tabla padre o primaria será titulos 
(vista de elementos) y la tabla hija o secundaria temas (vista de detalle). 


Definimos entonces la relación entre las tablas titulos y temas. Para ello, dirí- 
jase al panel Orígenes de datos (Ver > Otras ventanas > Origenes de datos), haga 
clic con el botón secundario del ratón en el nodo dsTitulosTemas y seleccione 
Editar DataSet con el diseñador. 


CAPÍTULO 13: ACCESO A UNA BASE DE DATOS 603 





4 gi temas 


Ed] id_tema 
E] tema 

4 gi titulos 
EX] id_libro 
EX] titulo 
E] id_tema 


Se mostrará una vista gráfica de las tablas y de los métodos que el asistente ha 
generado para acceder a los datos de las mismas. Para establecer la relación haga 
clic en el campo id tema (en la cabecera gris) de la tabla que va a actuar como 
padre (titulos) y arrástrelo hasta el campo id_tema de la tabla que va a actuar co- 


mo hija (temas): 


temas A 
Ê? id_tema id libro 
tema titulo 


ER temasTableAdapter Al id_tema 


ER ttlosTabiendapier F 





Se mostrará el diálogo siguiente en el que aparece la relación establecida y 
que, de no ser la esperada, podría modificar seleccionando los campos por los que 
se relacionarían las tablas primaria y secundaria. 
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fF = F = 


Nombre: 





titulos_temas 


Especifique las claves que relacionan tablas en el conjunto de datos. 
Tabla primaria: Tabla secundaria: 





(títulos y | (temas 





Columnas: 


Columnas de clave Columnas de clave externa 
id_tema | id_tema 











Elegir lo que se va a crear 
© Tanto relación como restricción Foreign Key 
© Sólo restricción Foreign Key 


(9) Sólo relación 


Regla de actualización: [Cascade 


Regla de eliminación: [Cascade 


Regla de aceptación o rechazo: | None 














7] Relación anidada 








Cuando haga clic en el botón Aceptar, la vista gráfica de las tablas se mostra- 
rá así: 


temas 
? id tema id_libro 
tema titulo 


E temasTableAdapter id_tema 


3) sutotabladaper 8 
sQ Fill GetData () 





Cierre la vista gráfica de las tablas. Ya tenemos el conjunto de datos que nos 
permite acceder a los datos de la base bd _libros y la relación entre las tablas del 
mismo. Sólo nos queda mostrar los datos en la interfaz gráfica de la aplicación. 
Vamos a utilizar una tabla (una rejilla) para visualizar los títulos de los libros y 
una etiqueta para mostrar el campo correspondiente al tema. 


Vuelva al panel de Orígenes de datos y despliegue la tabla titulos: 
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Orígenes de datos ” +] X 


CECE 0 
4 a dsTitulosTemas 


p gi temas 
euo E 
id_libro 
titulo 
id_tema 
4 gi temas 
E id_tema 
tema 





Al desplegar la tabla titulos observamos que muestra, además de los campos 
de esta tabla, los campos de la tabla secundaria temas (refresque la vista si es ne- 
cesario haciendo clic en el botón Refrescar de la barra de herramientas de este pa- 
nel). Todos los nodos muestran un icono a la izquierda que hace referencia al 
control que se utilizará para mostrar la tabla o el campo cuando se arrastre sobre 
la superficie de diseño. Haga clic en esos nodos y elija lo que quiere mostrar y so- 
bre qué control lo quiere hacer. Por ejemplo, en la figura siguiente se puede ob- 
servar que los campos id libro y titulo de la tabla titulos se van a mostrar en una 
rejilla (el icono a la izquierda de titulos corresponde a una vista en rejilla; el cam- 
po id_tema no se muestra), y que el campo tema de la tabla temas se va a mostrar 
como detalle en una etiqueta (el icono a la izquierda de tema corresponde a una 
caja de texto y lo cambiamos por una etiqueta; el campo ¡d_ tema no se muestra): 


Orígenes de datos aX 
CEEE 
4 a dsTitulosTemas 
p a temas 
a gi titulos 
id_libro 
titulo 
O id_tema 
4 gi temas 
O id_tema 
Z] tema >] 


TextBox 

















ComboBox 
Label 
LinkLabel 
ListBox 


` 


(E7 Ea -n' E] 


[Ninguno] 


Personalizar... 





A continuación, arrastre sobre la superficie de diseño la tabla titulos, establez- 
ca las propiedades necesarias para que presente un aspecto adecuado, y después 
arrastre el campo tema. Cuando haya finalizado, ejecute la aplicación. 


606 ENCICLOPEDIA DE MICROSOFT VISUAL C# 


Observe que cuando selecciona un libro en la tabla, la etiqueta “Tema” mues- 
tra el tema al que pertenece ese libro, y todo esto sin haber escrito nada de código. 
El resultado será análogo al mostrado en la figura siguiente: 


A 
a Formi arr] 
M 4/8 de24 |» | X W 


paa 
C/C ++. Curso de programación. RA-MA. 








| Programación orientada a objetos con C++. RA-MA. 


Encidinedía del lenguaje C++. RA-MA. 


| Java 2. Interfaces gráficas y aplicaciones para Intemet. RA-MA. 


Microsoft CH. Lenguaje y aplicaciones. RA-MA. 

pa 2. Curso de programación. RA-MA. 

Microsoft Visual Basic .NET. Lenguaje y aplicaciones. RA-MA. 
La Peste. EDHASA 

Luz sobre yoga. KAIROS. 





Literatura 











El diseño del proyecto maestro-detalle que hemos realizado no nos ha reque- 
rido escribir ni una sola línea de código, pero tampoco nos proporciona conoci- 
miento acerca de cómo proceder sin utilizar tanta asistencia. Por lo tanto, vamos a 
implementar una segunda versión de este proyecto que nos conduzca a la misma 
solución, pero ahora pensando en objetos. 


A la vista de la interfaz anterior, el usuario seleccionará un título en un con- 
trol DataGridView (este control muestra los títulos de la tabla titulos) y el tema 
correspondiente al título seleccionado le será mostrado en un control Label. Una 
posible forma de proceder para lograr este objetivo podría ser la siguiente: 


e Crear la base de datos bd libros con sus tablas titulos y temas. 


e Añadir al formulario un SqlDataAdapter: sqgldaTitulos. Configurarlo para 
que devuelva las filas de la tabla titulos. 


SELECT titulos.* FROM titulos 


e Crear un conjunto de datos dsTitulos a partir de sqldaTitulos. Será el origen 
de datos para la rejilla. 
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Añadir un DataGridView y vincularlo con la tabla titulos de dsTitulos para 
que muestre el título del libro y su identificador. Se crea un objeto titulosBin- 
dingSource como origen de datos de la rejilla. 


Llenar el conjunto de datos a partir de sg/daTitulos. 


private void Forml_Load(object sender, EventArgs e) 
{ 

sqldaTitulos.Fill(dsTitulos); 
) 


Añadir al formulario otro SqlDataAdapter: sqldaTemas. Configurarlo para 
que devuelva el campo temas.tema correspondiente al título seleccionado. 


SELECT tema, ¡id_tema FROM temas WHERE (id_tema = (ClDTema) 


El valor del parámetro (V/DTema (id) se obtendrá de la fila de titulosBinding- 
Source correspondiente a la fila seleccionada en la rejilla: 


sqldaTemas.SelectCommand.Parameters["eIDTema"].Value = id; 


Crear un nuevo conjunto de datos dsTemas a partir de sgldaTemas. Será el 
origen de datos para el control Label que mostrará el tema. 


Añadir un control Label y vincularlo con la tabla temas de dsTemas para que 
muestre el tema del título seleccionado. Se crea un objeto temasBindingSour- 
ce como origen de datos de la rejilla. 


Cada vez que se seleccione un título, llenar el conjunto de datos dsTemas a 
partir de sgldaTemas en función del id_ tema del título seleccionado. 


private void titulosDataGridView_RowEnter(object sender, 
DataGridViewCellEventArgs e) 
( 
try 
( 
dsTemas.Clear(); 
DataRowView fila = 
titulosBindingSourcele.RowIndex] as DataRowView; 
1f (fila.IsNew) return; 
int id = (int)fila["id_tema"]; 
sqldaTemas.SelectCommand.Parameters["GlDTema"].Value = id; 
sqldaTemas.Fill(dsTemas, "temas"); 
) 
catch (Exception exc) {} 


} 
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Inicialmente, cuando se cargue el formulario este método va a ser invocado 
más de una vez y puede ocurrir que Fill intente abrir un DataReader asocia- 
do a este Command cuando ya haya uno abierto, de ahí el bloque Try. 


Resumiendo: el origen de datos para el control DataGridView se obtiene a 
partir de una consulta a la base de datos que devuelve las filas de la tabla titulos, y 
el origen de datos del control Label que muestra el detalle, el tema del libro, se 
obtiene de una consulta a la base de datos que devuelve la fila de la tabla temas 
que tiene la misma clave ¡d_tema que la fila de la tabla titulos seleccionada en la 
rejilla; esto es, este último origen de datos tiene que actualizarse cada vez que se 
selecciona una nueva fila en la rejilla. 


EJERCICIOS RESUELTOS 


1. Realizar una aplicación que se encargue de gestionar una bodega que distribuye 
vinos a sus clientes. Un cliente realiza a la bodega un pedido con los productos 
que desea y la bodega se lo envía directamente a su domicilio. La gestión de los 
clientes y de los pedidos se hace a través de un formulario MDI con tres formula- 
rios hijo: nuevo cliente, realizar pedido y mostrar pedidos. 


Para empezar, arrancamos Visual Studio y creamos un nuevo proyecto Apli- 
cación de Windows Forms denominado bodega. 


Base de datos 


Como siguiente paso vamos a crear la base de datos. Si instaló Visual Studio Ex- 
press o Visual Studio, entonces es posible añadir al proyecto elementos nuevos de 
tipo base de datos. Según esto, haga clic con el botón secundario del ratón sobre 
el nombre del proyecto y añada un nuevo elemento del tipo Base de Datos basada 
en servicio denominado bd _bodega.mdf. Esta acción generará una base de datos 
vacía. A continuación, el asistente para la configuración de bases de datos mostra- 
rá una ventana que le permitirá elegir el modelo de la base de datos con el que va 
a trabajar; como está vacía, haga clic en el botón Cancelar. 
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r S > 
Asistente para la configuración de orígenes de datos 2 [mesas] 





Ca Elegir un modelo de base de datos 


¿Qué tipo de modelo de base de datos desea usar? 


Ss 9 


| Conjunto de Entity Data 
Model 










El modelo de base de datos que elija determina los tipos de objetos de datos que utiliza el código de la aplicación. 
Se agregará un archivo de conjunto de datos al proyecto. 














Gran] e) Ea] 
lo 








Obsérvese que los ficheros de la base de datos han sido guardados en el direc- 
torio de la aplicación. 


Explorador de soluciones Y Ax 
6 0-00 rR 
Buscar en el Explorador de soluciones (Ctrl+”) P~ 


E] Solución 'bodega' (1 proyecto) 
4 E] bodega 

b # Properties 

D =m References 

A app.config 
“n) bd_bodega_log.Idf 
b Forml.cs 
D œ Program.cs 





Explorador de soluciones Vista de clases 


Como estamos trabajando con una base de datos local, de forma predetermi- 
nada, cuando genera el proyecto, esta base de datos se copia a la carpeta de resul- 
tados bin (seleccione Mostrar todos los archivos en el Explorador de soluciones 
para ver la carpeta bin). Este comportamiento se debe a la propiedad Copiar en el 
directorio de resultados del fichero base de datos, que tiene como valor predeter- 
minado Copiar siempre. Esto significa que la base de datos de la carpeta bin se 
copiará cada vez que se genere, depure o ejecute la aplicación, con lo que no se 
guardarán los cambios de una ejecución para otra; por lo tanto, cambie este valor 
a Copiar si es posterior. 
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Propiedades "01x 
bd_bodega.mdf Propiedades del archivo > 
[5] £ 

Acción de compilación Contenido 


Copiar en el directorio de resultados Copiar si es posterior| y 


Espacio de nombres de la herramienta perst 














Herramienta personalizada 





Nombre de archivo bd_bodega.mdf 


En el siguiente paso vamos a añadir las tablas a la base de datos. Vamos a 
crear tres tablas: clientes, productos y pedidos. Para ello, diríjase al Explorador de 
soluciones y haga doble clic sobre el nodo bd bodega.mdf. Esto hará que se 
muestre el Explorador de servidores con la composición de la base de datos: 





Explorador de servidores 


Q hk eai 


4 gl Conexiones de datos - 
4 E bd_bodega.mdf 
> El Vistas ` 
El Procedimientos almacenados 


E Sinónimos 
E Tipos 
> ml Ensamblados v 
Explorador de se... Cuadro de herra... Explorador de o... 


b 
b E Funciones 
b 
b 











Para añadir las tablas, podemos proceder de dos formas: utilizando un script 
(localizado en la carpeta Cap13 del CD) o utilizando el diseñador de tablas. 


Si utilizamos un script, haga clic con el botón secundario del ratón en el nodo 
bd_bodega.mdf, en el Explorador de servidores, y ejecute la orden Nueva consul- 
ta del menú contextual que se visualiza. Se muestra el editor de SQL. Copie el 
script y haga clic en el botón Ejecutar de este panel. Cierre el panel, refresque la 
base de datos y observe las tablas que se han creado. 


Si utilizamos el diseñador de tablas, haga clic con el botón secundario del ra- 
tón en el nodo Tablas, en el Explorador de servidores, y ejecute la orden Agregar 
nueva tabla del menú contextual que se visualiza. Se muestra el diseñador de ta- 
blas que consta de la rejilla de columnas, el panel de scripts y el panel de contex- 
to. Edite la tabla clientes como se muestra a continuación. En el panel de scripts, 
cambie el nombre de la nueva tabla a clientes. Posteriormente, para crear nuevas 
referencias de clave externa, haga clic con el botón secundario en el nodo Claves 
externas del panel de contexto y seleccione Agregar nueva clave externa. 
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Form1.vb [Diseño] X 








Actualizar Archivo de script: dbo.clientes.sql y 























Nombre Tipo de datos Permitir valores NUL 4 Claves (1) 
*”o Cliente nchar(9) | PK_dlientes (Clave principal, Ch. 
Nombre nvarchar(20) El o CHECK (0) 
x A Indices (0) 
Apellidos nvarchar(40) O 
= Claves externas (0) 
ES ] 
Direccion nvarchar(100) O D danadores (0) 
Telefono nchar(13) E] 
Correo_e nvarchar(30) m] 
E 
[B Diseñar 14 / 8 T-SQL | == mam 
=CREATE TABLE [dbo]. [clientes] ( + 
| [Cliente] NCHAR (9) NOT NULL, a 


[Nombre] NVARCHAR (20) NOT NULL, 

[Apellidos] NVARCHAR (40) NOT NULL, 

[Direccion] NVARCHAR (100) NOT NULL, 

[Telefono] NCHAR (13) NULL, 

[Correo_e] NVARCHAR (30) NULL, 

| CONSTRAINT [PK_clientes] PRIMARY KEY CLUSTERED ([Cliente] ASC) 
); 

100% ~ 4 » 

mí Conexión lista | (LocalDB)w11.0 | ficeballos-POriceballos | CAUSERSFICEBALLOSDO... 


Obsérvese que Cliente (número de cliente) se ha establecido como clave prin- 
cipal (clic con el botón secundario del ratón sobre la cabecera de la fila y ejecutar 
la orden Establecer clave principal del menú contextual que se visualiza). 


Para guardar la tabla clientes haga clic en Actualizar (esquina superior iz- 
quierda del diseñador). Siguiendo un proceso análogo, edite las tablas productos y 
pedidos y establezca las relaciones entre las tablas, según se muestra a continua- 
ción: 


Forml.vb [Diseño] X 





% Actualizar | Archivo de script: dbo.productos.sql y 























Nombre Tipo de datos Permitir valore! 4 Claves (1) 
ro Clave nchar(7) o PK_productos_1 (Clave principal, Clu 
Descripcion nvarchar(50) O Tautrier CHECK (0) 
3 = Indices (0) 
Embalaje nvarchar(30) E 
=- Claves externas (0) 
= e Desencadenadores (0) 
Stock int a 
y 4 » 
(B Diseñar $" S T-SQL === ls El 
CREATE TABLE [dbo]. [productos] ( + 
[Clave] NCHAR (7) NOT NULL, a 
[Descripcion] NVARCHAR (50) NOT NULL, 
[Embalaje] NVARCHAR (30) NOT NULL, 
[PVP] REAL NOT NULL, 
[Stock] INT NOT NULL, 
CONSTRAINT [PK_productos_1] PRIMARY KEY CLUSTERED ([Clave] ASC) 
100% + 4 b 


m} Conexión lista | (LocalDB)\v11.0 | fjceballos-PC\fjceballos | C\USERS\FJCEBALLOS\DO... 
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AR Forml.vb [Diseño] X 


% Actualizar Archivo de script: dbo.pedidos.sq! y 




















Nombre Tipo de datos Permitir valore! 4 Claves (1) 
© Pedido int PK_pedidos (Clave principal, Clustere 
Cliente nchar(9) So CHECK (0) 
_ Índices (0) 
Clave nchar(7) 
4 Claves externas (2) 
A = Sa FK_pedidos_clientes (Cliente) 
Coste real L FK_pedidos_productos (Clave) 
Fecha datetime Desencadenadores (0) 
Servido bit 

4 » 

Q Diseñar t S T-SQL aa 

CREATE TABLE [dbo]. [pedidos] ( + 

[Pedido] INT NOT NULL, a 
[Cliente] NCHAR (9) NOT NULL, 
[Clave] NCHAR (7) NOT NULL, 
[Cantidad] INT NOT NULL, 
[Coste] REAL NOT NULL, 
[Fecha] DATETIME NOT NULL, 
[Servido] BIT NOT NULL, 


CONSTRAINT [PK_pedidos] PRIMARY KEY CLUSTERED ([Pedido] ASC), 
CONSTRAINT [FK_pedidos_clientes] FOREIGN KEY ([Cliente]) REFERENCES [dbo]. [c 
CONSTRAINT [FK_pedidos_productos] FOREIGN KEY ([Clave]) REFERENCES [dbo]. [pr 


100% ~ 4 $ 
mi Conexión lista | (LocalDB)ww11.0 | ficeballos-POYiceballos | CAUSERSAFICEBALLOSIDO... 


Ya tenemos las tres tablas. Sólo nos falta establecer las relaciones entre ellas. 
Hay dos formas de hacer esto, desde el nodo Claves externas del panel de contex- 
to o desde un diagrama visual de la base de datos. 


Desde el nodo Claves externas, haga clic con el botón secundario en el nodo 
Claves externas del panel de contexto y seleccione Agregar nueva clave externa. 


Y desde un diagrama visual de la base de datos, diríjase al Explorador de ser- 
vidores, haga clic con el botón secundario del ratón en el nodo Diagramas de ba- 
se de datos y ejecute la orden Agregar nuevo diagrama del menú contextual que 
se visualiza. A continuación, añada todas las tablas a ese diagrama. Para relacio- 
nar el campo Cliente de la tabla pedidos con el campo Cliente de la tabla clientes 
haga clic con el botón primario del ratón en el primero y arrastre la corresponden- 
cia hasta el segundo. Acepte los valores por defecto establecidos para la relación 
añadida. Ídem para relacionar el campo Clave de la tabla pedidos con el campo 
Clave de la tabla productos. 
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* Cliente 
Nombre 


Apellidos 
Direccion 
Pedido Telefono 


Cliente Correo_e 


Clave E clientesTableAdapter — [2] 


Cantidad 
antida SQL Fill GetData 0 


Coste 
Fecha 
Servido 





Descripcion 
SQ Fil. GetData 0 Embalaje 

PVP 

Stock 





Ñ Fil. GetData 0 


Para poder hacer pruebas con la base de datos construida, vamos a añadir al- 
gunos registros. Para ello, haga clic con el botón secundario del ratón en el nodo 
de cada tabla y ejecute la orden Mostrar datos de tabla del menú contextual que 
se visualiza. Finalmente, guardamos todo el proyecto. 


Capa de acceso a datos 


Continuando con la aplicación, vamos a crear una capa de acceso a datos que nos 
permita abstraernos de las operaciones con bases de datos. Para ello, diríjase al 
panel Orígenes de datos (Ver > Otras ventanas > Origenes de datos), o bien eje- 
cute la orden Agregar nuevo origen de datos del menú Proyecto. A continuación 
cree tres conjuntos de datos (DataSet): dsClientes, dsProductos y dsPedidos. Para 
crear uno de estos conjuntos de datos elija: 


Tipo de origen de base de datos: Base de datos. 
Modelo de base de datos: Conjunto de datos. 
Conexión de datos: bd_bodega.mdf. 

Objetos de base de datos: tabla clientes. 
Nombre del DataSet: dsClientes. 





Orígenes de datos 


whan 


> "ESE 


b g dsPedidos 
b g dsProductos 


Repita este proceso para dsProductos y dsPedidos. Una vez creados, obsérve- 
se que se puede abrir el DataSet y analizar su contenido. 
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Orígenes de datos ax 

tu € a 0 

b a dsClientes 

4 a dsPedidos 

- PE 

EH] Pedido 

= Cliente 

æ] Clave 

mæ] Cantidad 

m] Coste 
Fecha 
Servido 

b g dsProductos 





























Así mismo, si hace doble clic sobre el nombre del DataSet, o bien hace clic 
con el botón secundario del ratón y ejecuta la orden Ver diseñador del menú con- 
textual que se visualiza, se mostrará la siguiente ventana: 


EEE 7 Forml.vb [Diseño] 


? Pedido 
Cliente 
Clave 
Cantidad 
Coste 


Fecha 


Servido 





La figura anterior muestra dos objetos: pedidos de la clase DataTable y pedi- 
dosTableAdapter de la clase TableAdapter. El primero hace referencia a la tabla 
del DataSet, y el segundo, al adaptador que se utilizará para, ejecutando la orden 
SQL adecuada, llenar la tabla del DataSet. Esto es lo que anteriormente denomi- 
namos “acceso desconectado a base de datos”. El adaptador presenta dos métodos: 
Fill y GetData. El método Fill toma como parámetro un DataTable o un DataSet 
y ejecuta la orden SQL programada (puede verla haciendo clic con el botón se- 
cundario del ratón en el título de cualquiera de los dos paneles y ejecutando la or- 
den Configurar del menú contextual que se visualiza). El método GetData 
devuelve un nuevo objeto DataTable con los resultados de la orden SQL. Tam- 
bién se han creado los métodos /nsert, Update y Delete que se pueden llamar para 
enviar cambios de filas individuales directamente a la base de datos. 


Así mismo, en la vista de clases puede ver la funcionalidad proporcionada por 
cada una de las clases de los conjuntos de datos añadidos, funcionalidad que utili- 
zaremos cuando sea necesario. 
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Interfaz gráfica 


El siguiente paso es crear la interfaz gráfica. Ésta va a consistir en un formulario 
principal tipo MDI y tres formularios hijo: Nuevo cliente, Realizar pedido y Mos- 
trar pedidos. Este trabajo ya fue realizado en el apartado Ejercicios resueltos del 
capitulo Interfaz para múltiples documentos, por lo que no lo repetiremos aquí. El 
aspecto de este formulario es el siguiente (en la figura, el formulario MDI está 
mostrando el formulario hijo Nuevo cliente): 


r 
al Bodega - [formNuevoCliente] Le] ES) 


& Nuevo diente EA Realizar pedido Œ Mostrar pedidos 








Cliente: 000000008 
Nombre: Alberto 

Apellidos: Castillo 

Direccion: — Herreros 

Telefono: 913333333 
Correoe: alberto @hotmail.com 








fjes 








Nuevo cliente 


En este apartado vamos a implementar el formulario que nos permitirá añadir un 
nuevo cliente a la base de datos. Para ello, en el formulario Nuevo cliente hay que 
añadir los controles que permitan introducir los datos de un cliente; una vez intro- 
ducidos estos, serán registrados en la base de datos tras hacer clic en el botón 
Aceptar. 


Una forma sencilla de hacer lo indicado en el párrafo anterior es dirigirse al 
panel Orígenes de datos y arrastrar la tabla clientes del conjunto de datos dsClien- 
tes. Observando la figura siguiente, vemos a la izquierda de la entidad clientes un 
icono: DataGridView, Detalles, etc. 
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Orígenes de datos vax 


CER E 
4 a dsClientes 


fa 








b a doll] DataGridView 


Personalizar... 











» a dsl O] Detalles 
© [Ninguno] 





El icono al que nos hemos referido en el párrafo anterior, seleccionable ha- 
ciendo clic con el ratón en el botón situado a la derecha de la entidad, indica el 
control o controles que se añadirán sobre el formulario para acceder al origen de 
datos. Nosotros vamos a elegir Detalles para que se añada una caja de texto por 
cada uno de los campos que forman un registro de un cliente. Establezca la pro- 
piedad Anchor para esas cajas de texto al valor Top, Left, Right. 


Según lo expuesto, visualice el formulario Nuevo cliente y arrastre sobre él el 
detalle de un registro de clientes desde el origen de datos dsClientes. Esta opera- 
ción añadirá al formulario formNuevoCliente un conjunto de datos dsClientes, de 
tipo dsClientes, un adaptador clientesTableAdapter para llenar la tabla de dsClien- 
tes y un control BindingNavigator con su origen de datos BindingSource conec- 
tado al origen de datos dsClientes. Esta barra de navegación no la necesitamos, ya 
que lo que se pretende con este formulario es simplemente añadir un nuevo cliente 
a la tabla clientes de la base de datos. Por lo tanto, la ocultaremos poniendo su 
propiedad Visible a false. 





MAI formBuscarCodCliente.cs Forml1.cs [Diseño] v 





formNuevoCliente 


Nombre: 
Apellidos: P 
Direccion: 
Telefono: 


Correo e: 


ğ Aceptar E Cancelar 











a dsClientes Wi clientesBindingSource è clientesTableAdapter F clientesBindingNavigator 


Para guardar el nuevo registro, en lugar del control BindingNavigator utili- 
zaremos el botón Aceptar. Para editar el controlador de este botón haga doble clic 
sobre él. En el panel de código que se visualiza, observaremos dos métodos, form- 
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NuevoCliente_ Load y clientesBindingNavigatorSaveltem_ Click, que fueron aña- 
didos por el asistente cuando arrastramos la tabla. El primero carga los datos en la 
tabla clientes del conjunto de datos (se ejecuta cuando se carga el formulario) y el 
segundo actualiza la base de datos con los cambios que se hayan efectuado (se 
ejecuta al hacer clic en el botón guardar del navegador). 


El método clientesBindingNavigatorSaveltem_ Click ya no tiene sentido pues- 
to que hemos ocultado el navegador. Esta operación la realizará ahora el botón 
Aceptar. Por lo tanto, copie el código de ese método en btAceptar Click y elimine 
el método clientesBindingNavigatorSaveltem_ Click, o bien no lo elimine y haga 
simplemente una llamada al mismo. 


private void btAceptar_Click(object sender, EventArgs e) 
( 
if (this.Validate()) 
( 
try 
( 
this.clientesBindingSource.EndEdit(); 
this.clientesTableAdapter.Update(this.dsClientes.clientes); 
) 
catch (Exception ex) 
( 
MessageBox.Show("Error: " + ex.Message); 
) 
) 


else 
MessageBox.Show(this, "Errores de validación.", "Guardar", 


MessageBoxButtons.0OK, MessageBoxIcon.Warning); 
this.Close(l); 


} 


El método anterior realiza una validación de los datos y si resulta positiva ac- 
tualiza la base de datos. El método Validate valida el último control no validado 
y sus predecesores, pero sin incluir el control actual. Esta versión del método 
siempre realiza la validación, independientemente del valor de la propiedad Au- 
toValidate del control padre. Por consiguiente, úselo para forzar una validación 
incondicional. 


Nota: elimine el método btAceptar Click de la plantilla (clase padre del for- 
mulario) ya que si no, será invocado antes de ejecutar el método anterior, y cierre 
el formulario desde este último. 


¿Con qué se actualizará la base de datos al hacer clic en el botón Aceptar? 
Pues tiene que actualizarse con el nuevo cliente. Entonces hay que crear un nuevo 
registro cuyos datos introduciremos a través de formNuevoCliente. Esta operación 
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es la que tiene que hacer el método formNuevoCliente_Load. Por lo tanto, redefi- 
na este método como se indica a continuación: 


private void formNuevoCliente_Load(object sender, EventArgs e) 
( 
// Añadir un nuevo registro 
this.clientesBindingSource.AddNew(); 
) 


Este método crea un nuevo registro en la tabla de dsClientes, que después 
guardamos haciendo clic en el botón Aceptar. Pero fíjese en que no hemos hecho 
ninguna validación de los datos antes de guardar el registro. Éste será el siguiente 
paso a desarrollar. 


Para validar los datos introducidos en el formulario, podemos hacer uso de los 
manejadores para los eventos Validating y Validate, del control ErrorProvider, 
del control MaskedTextBox, etc. (véase el capitulo titulado Introducción a Win- 
dows Forms). Nosotros, a modo de ejemplo, vamos a realizar una validación sen- 
cilla: que el contenido de las cajas de texto para los campos Cliente, Nombre, 
Apellidos y Dirección no sea nulo, que es lo que exigimos al crear la base de da- 
tos. Según esto, añada el controlador del evento Validating para estas cajas de 
texto y edítelo análogamente a como se indica a continuación para la caja de texto 
ClienteTextBox: 


private void clienteTextBox_Validating(object sender, CancelEventArgs e) 
( 
if (clienteTextBox.Text.Length == 0) 
e.Cancel = true; 


Además de la validación anterior, es necesario también mostrarle al usuario 
información de qué es lo que está haciendo mal. Para hacer esto vamos a utilizar 
el control ErrorProvider, que nos permite asociar un mensaje con un control de- 
terminado, de forma que si en ese control ocurre un error, aparecerá un icono al 
lado que mostrará el mensaje nada más pasar el ratón sobre él. Según lo expuesto, 
añada uno de estos controles al formulario. 


Una vez añadido el control errorProviderl, modifique los controladores que 
acabamos de añadir de forma análoga a como se indica a continuación: 


private void clienteTextBox_Validating(object sender, CancelEventArgs e) 
( 

if (clienteTextBox.Text.Length == 0) 

( 


e.Cancel = true; 
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errorProviderl.SetError(clientelextBox, 
"Introduzca el identificador del cliente"); 


) 
else 
errorProviderl.SetError(clientelextBox, null); 


Ahora puede ejecutar y comprobar el funcionamiento de la aplicación. 


Realizar pedido 


En este apartado vamos a implementar el formulario que permitirá realizar un pe- 
dido que registraremos en la tabla pedidos de la base de datos. Un pedido se hará 
en base a los elementos disponibles en la tabla productos. El aspecto de este for- 
mulario se muestra a continuación. 





RI formRealizarPedido.cs Forml.cs [Diseño] X 





formRealizarPedido 


E) 


ü 
Código del cliente 


Clave Descripcion Embalaje PVP Stock 





4 








Cantidad 1 


ETT 








w ra pea „o 
ie" dsProductos S productosBindingSource $8 productosTableAdapter w productosBindingNavigator 


En primer lugar muestra una etiqueta y una caja de texto para escribir el códi- 
go del cliente que realiza el pedido. Para facilitar la obtención del código del 
cliente, hemos añadido un botón a la derecha de la caja que mostrará un diálogo 
Buscar código del cliente. Establezca la propiedad Anchor para estos controles. 


Después, muestra una rejilla vinculada con el origen de datos productos. 
Arrastre esta entidad desde el panel origen de datos. Para personalizar esta rejilla, 
abra su menú de tareas, deshabilite las operaciones de agregar, editar y eliminar 
filas, y quite la columna Stock. Después, desde la ventana de propiedades asigne a 
su propiedad AutoSizeColumnsMode el valor 4//Cells; a SelectionMode, el va- 
lor FullRowSelect, a MultiSelect, el valor false para que solo se pueda seleccio- 
nar una fila cada vez; y a su propiedad Anchor, el valor Top, Left, Right. 
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Debajo de la rejilla se muestra una etiqueta y una caja de texto para escribir la 
cantidad comprada del producto elegido (por omisión será 1). 


Finalmente, oculte la barra de navegación y elimine el método productosBin- 
dingNavigatorSaveltem_Click. 


Vamos a diseñar el diálogo Buscar código del cliente. Añada al proyecto un 
nuevo formulario y haga que se derive de plantilla de formularios. El formulario 
tendrá el aspecto de la figura mostrada a continuación: 





y 
formPlantilla 








Nombre o apellidos Buscar 


Apellidos 











Aceptar | Cancelar 

















La caja de texto permitirá introducir el nombre o apellidos total o parcialmen- 
te (se trata de una subcadena para buscar en los campos Nombre y Apellidos) con 
la intención de obtener en una rejilla los registros coincidentes y seleccionar el 
cliente buscado para obtener su código de cliente. 


Añada la rejilla a la que hemos hecho referencia (objeto DataGridView). Há- 
galo arrastrando la entidad clientes desde el panel origen de datos. Esta acción 
añade los componentes dsClientes, clientesBindingSource y clientesDataAdapter. 
A continuación, abra su menú de tareas para configurarla. Asígnele el origen de 
datos clientes, deshabilite las operaciones de agregar, editar y eliminar filas, y qui- 
te las columnas Dirección, Teléfono y Correo e. Después, desde la ventana de 
propiedades asigne a su propiedad AutoSizeColumnsMode el valor Fill, a Mul- 
tiSelect, el valor false; y a su propiedad Anchor, el valor Top, Left, Right. 


Queda escribir el código del controlador del botón Buscar. Al hacer clic en 
este botón, la rejilla tiene que mostrar los registros de clientes que en sus campos 
Nombre o Apellidos contengan el texto escrito en la caja de texto. Si la caja de 
texto se deja vacía, se mostrarán todos los registros. 
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Diríjase al panel Orígenes de datos y muestre el DataSet dsClientes en el di- 


señador: 


| dsClientesxsd* 3 X| formBuscarCodCliente.cs [Diseño] formRealizarPedido.cs [Diseño] 


clientes a 
Agregar 








? Cliente N 
Nombre Configurar... E Relación... 
Apellidos XÆ Cortar Ctrl+X R% Clave... 
Direccion dl Copiar Ctrl+C Columna Ctri+L 
Telefono DRT 0 
Correo_e 

= X Eliminar Supr 

f clientesTableAdapte MN 

Y X3 Cambiar nombre 

sQL Fill GetData 0 Pa ao A 

53L FillByNombreApellidos, TEE CE 

Vista previa de datos... 
<> Ver código 
Propiedades Alt+Entrar 














Consulta... 








Si lo desea, puede comprobar que el adaptador actual está configurado para 
extraer todos los registros de la tabla clientes (método Fill). Por lo tanto, tenemos 
que escribir una nueva orden SELECT que nos filtre estos registros. Para ello, 
ejecute la orden Agregar > Consulta del menú contextual del conjunto de datos. 
Se mostrará el asistente para la configuración de consultas. Elija usar una instruc- 
ción SQL que devuelva filas y utilice el generador de consultas para generar dicha 


consulta: 





y 
Generador de consultas 


a 


== ES) 





E 


dientes 











Cliente 








Nombre 








Apellidos 
Direccion 

















Mo |< 


Columna Alias 
Nombre 


Apellidos 





[]* (Todas las columnas) a 
Y 
Y 

El 


Tabla Resul... 


dientes al 





E 


clientes 


Tipo de ... Criterio de or... Filtro O... [6] 


m) >| 


LIKE @cadena H 
LIKE @cadena tá 





m. 


| r 








(Apellidos LIKE @cadena) 


SELECT Cliente, Nombre, Apellidos, Direccion, Telefono, Correo_e 
FROM dientes 
WHERE (Nombre LIKE @cadena) OR 





| Cliente Nombre 


Apellidos 


Direccion 


Telefono Correo_e 





* 








[Nuu NULL 
0 [de 0 


Ejecutar consulta 


NULL 


NULL 


NULL NULL | 





Aceptar || Cancelar | 














BO J 
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Obsérvese en la figura anterior que la consulta se realizará en base al paráme- 
tro cadena. Una vez que tenemos la instrucción SQL, el asistente nos permitirá, a 
continuación, elegir los métodos que se van a agregar al TableAdapter para eje- 
cutar la consulta: FillByNombreApellidos y GetDataByNombreApellidos. 


Una vez añadida la nueva consulta al adaptador, volvemos al diálogo, elimi- 
namos el método formBuscarCodCliente Load y editamos el controlador del bo- 
tón Buscar así: 


private void btBuscar_Click(object sender, EventArgs e) 
( 
clientesTableAdapter.FillByNombreApellidos( 
dsClientes.clientes, "%" + ctApellidosNombre.Text + "%"); 


Obsérvese que este método, ejecutando la consulta implementada por Fi- 
lIByNombreApellidos en el adaptador clientesTableAdapter, llena la tabla dsClien- 
tes.clientes que es el origen de datos especificado para la rejilla. El método 
FillByNombreApellidos especifica en su segundo parámetro la cadena utilizada 
para realizar la búsqueda. 


Para mostrar este diálogo, como modal, edite el controlador del botón de títu- 
lo “...”, que pusimos en el formulario Realizar pedido, como se indica a continua- 
ción: 


private void btBuscar_Click(object sender, EventArgs e) 

( 
formBuscarCodCliente formBuscar = new formBuscarCodCliente(); 
formBuscar.ShowDialog():; 

) 


Una vez mostrado el diálogo Buscar código del cliente, queremos que al ha- 
cer clic en el botón Aceptar se obtenga el código del cliente de la fila seleccionada 
y se utilice para rellenar la caja correspondiente del diálogo Realizar pedido. 


Este código de cliente lo vamos a almacenar en un atributo público, codigo- 
Cliente, que vamos a añadir a la clase del formulario Buscar código del cliente: 


public partial class formBuscarClodCliente : formPlantilla 
( 

public string codigoCliente; 

11 


Después, editamos el controlador del botón Aceptar del formulario Buscar 
código del cliente como se indica a continuación: 
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private void btAceptar_Click(object sender, EventArgs e) 
( 
codigoCliente = 
dsClientes.clientes[clientesBindingSource.PositionJ].Cliente; 
Closeí); 
) 


El objeto BindingSource hace de puente entre el control y el conjunto de da- 
tos, proporcionando acceso a los datos actualmente mostrados por el control de 
una forma indirecta, incluyendo navegación, ordenación, filtrado y actualización. 


Para rellenar la caja correspondiente del diálogo Realizar pedido, añada al 
controlador de su botón de titulo “...” la sentencia indicada a continuación: 


private void btBuscar_Click(object sender, EventArgs e) 

( 
formBuscartodCliente formBuscar = new formBuscarCodCliente(); 
formBuscar.ShowDialog(); 
ctCliente.Text = formBuscar.codigoCliente; 

) 


Como alternativa, puede hacer esto mismo en el método que responda al 
evento doble clic de las celdas de la rejilla. 


A 
a Bodega - [formRealizarPedido] b- | 0) ks 


& Nuevo diente ¡EA Realizar pedido Œ} Mostrar pedidos 








ol=isj[e{o 
Código del cliente 000000005 


| Clave Descripcion 
Durón Gran Reserva 1991 
| 1298N60 | Durón Reserva 1998 Caja de Cartón 6 Botellas |88,16 
| 1301C90 | Durón Crianza 2001 [Caja de Cartón 12 Botellas (98,64 „| 


m | + 








( Aceptar | l Cancelar ] 











fjes 


¿Qué tenemos que hacer a continuación? A la vista del formulario anterior, el 
usuario de la aplicación elegirá el producto deseado, escribirá la cantidad de uni- 
dades requerida y hará clic en el botón Aceptar. La respuesta a este clic tiene que 
ser guardar este pedido en la tabla de pedidos si hay stock suficiente, decrementar 
el stock y actualizar la tabla productos con el nuevo stock. Parte de este proceso 
(lo que no esté relacionado con el componente dsProductos de este formulario) lo 
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vamos a implementar en una clase LogicaNegocio con el fin de no incluir en el 
formulario operaciones típicas de la capa de acceso a datos. Según esto el formu- 
lario simplemente invocará a un método RealizarPedido de esta clase pasándole 
como argumentos el cliente que realiza el pedido, el producto y la cantidad pedida 
del mismo. Después, decrementará el stock y actualizará la tabla productos. 


private void btAceptar_Click(object sender, EventArgs e) 
( 
// Si no se introdujo el código de cliente, solicitarlo 
if (ctCliente.Text.Length == 0) btBuscar.PerformClick(); 
if (ctCliente.Text.Length == 0) return; 


// Realizar pedido si hay stock 
if (Convert.Tolnt32(ctCantidad. Text) <= 
dsProductos.productos[productosBindingSource.Position].Stock) 








dsProductos.productosRow producto = 
dsProductos.productos[productosBindingSource.Position]; 
LogicaNegocio.RealizarPedido( 
etcliente. ext, producto, Convert. Tolnt32(ctCantidad.ext)); 
dsProductos.productos[productosBindingSource.Position].Stock 
-= Convert.Tolnt32(ctCantidad.Text); 
productosTableAdapter.Update(dsProductos.productos 
Close(); 
} 
else 
MessageBox.Show("La cantidad supera el stock"); 




















Las sentencias sombreadas deberían realizarse como una operación atómica. 
Esto es, supongamos que al ejecutarse Update ocurre un error. El resultado sería 
que hemos realizado un pedido pero no se ha decrementado el stock en la tabla 
pedidos, lo cual no es coherente. Para evitar incoherencias como la mencionada, 
este tipo de operaciones sobre la base de datos deben ser transaccionales. Esto es, 
las operaciones mencionadas anteriormente deben ocurrir en una misma transac- 
ción para si ocurre un error, poder echar atrás toda esa transacción. Visual Studio 
proporciona una nueva técnica para trabajar con transacciones a través de la bi- 
blioteca System.Transactions. 


¿Cómo guardar datos utilizando una transacción? La forma más fácil de im- 
plementar una transacción es crear un objeto de la clase TransactionScope del 
espacio de nombres System.Transactions, para utilizarlo después en una senten- 
cia using. El código ejecutado dentro de using participará en la transacción. 


Para ejecutar la transacción hay que invocar al método Complete al final del 
bloque using, y para echar atrás la transacción basta con que se lance una excep- 
ción antes de la llamada al método Complete. 
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TransactionScope tr = new TransactionScope(l); 
using (tr) 
( 
dsProductos.productosRow producto = 
dsProductos.productos[productosBindingSource.Position]; 
LogicaNegocio.RealizarPedido( 
ctCliente.Text, producto, Convert.Tolnt32(ctCantidad.Text)); 
dsProductos.productos[productosBindingSource.Position].Stock 
-= Convert.Tolnt32(ctCantidad.Text); 
productosTableAdapter.Update(dsProductos.productos):; 
tr.Complete(); 





Dependiendo de la versión de SQL Server que esté utilizando, cuando ejecute 
la aplicación, esta puede lanzar la excepción siguiente si el servicio DTC (coordi- 
nador de transacciones distribuidas) no está arrancado. En este caso, muestre los 
servicios de su máquina y arranque el servicio DTC. 


[formRealizarPedido] 


aplicación omitirá este error e intentará continuar. Si hace clic en Salir, la 
aplicación se cerrará inmediatamente. 


9 Excepción no controlada en la aplicación. Si hace clic en Continuar, la 


MSDTC on server 'PCWIRTUALLEO03290B8-5E 28-42 is unavailable. 


( Continuar ] ( Salir 











El paso siguiente es añadir a la aplicación la clase LogicaNegocio y escribir 
su método static RealizarPedido. ¿Qué tiene que hacer este método? Pues añadir 
un nuevo pedido a la tabla pedidos de la base de datos. Los datos para este nuevo 
registro son proporcionados por los parámetros del método: cliente, producto y 
cantidad. 


Este método, según se puede observar a continuación, crea un adaptador de la 
clase pedidos TableAdapter que se añadió al proyecto cuando se creó el origen de 
datos dsPedidos, crea un conjunto de datos de la clase dsPedidos, obtiene los da- 
tos para el nuevo registro, añade este registro al conjunto de datos anteriormente 
creado, y actualiza la tabla pedidos de la base de datos desde ese conjunto de da- 
tos invocando al método Update del adaptador. La ejecución de este método hace 
que el adaptador conecte con la base de datos y ejecute las instrucciones SQL 
adecuadas para actualizar la tabla pedidos de la base de datos. 


public class LogicaNegocio 
( 
public static void RealizarPedido(string cliente, 
dsProductos.productosRow producto, int cantidad) 
( 
// Agregar un pedido 
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PedidosTableAdapters.pedidosTableAdapter adaptador = 

new dsPedidosTableAdapters.pedidosTableAdapter(); 

Pedidos datos = new dsPedidos(); 

aptador.Fill(datos.pedidos); 

Añadir el pedido a la tabla pedidos desde "datos" 

t pedido = datos.pedidos.Count; 

ring clave = producto.Clave; 

oat coste = producto.PVP * cantidad; 

telime fecha = DateTime.Now; 

ol servido = false; 

tos.pedidos.AddpedidosRow(pedido, cliente, clave, 
cantidad, coste, fecha, servido); 

Actualizar la base de datos desde "datos" 

aptador.Update(datos); 





Mostrar pedidos 


En este 


apartado vamos a implementar el formulario que nos permitirá mostrar y 


servir los pedidos registrados en la base de datos. El aspecto de este formulario se 
muestra a continuación. 





A = = 5 
m IES 
all Bodega - [formMostrarPedidos] ee 


& Nuevo diente E Realizar pedido EM: Mostrar pedidos 


Clave i Fecha Servido 
nanea | [16/04/2007..| Ml 
C198N61 18/03/2013... | 
C301N90 18/03/2013... | 
5404V90 |18/03/2013... 




































































raa 





El formulario de la figura anterior muestra una rejilla vinculada con el origen 
de datos pedidos. Esto lo puede conseguir arrastrando esta entidad desde el panel 
origen de datos. A continuación, para personalizar la rejilla abra su menú de tareas 
y deshabilite las operaciones de agregar, editar y eliminar filas. Después, desde la 
ventana de propiedades asigne a su propiedad AutoSizeColumnsMode el valor 
Fill, a MultiSelect, el valor false; a SelectionMode, el valor FullRowSelect, y a 
su propiedad Anchor, el valor Top, Bottom, Left, Right. 
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Finalmente, oculte la barra de navegación y elimine el método pedidosbin- 
dingNavigatorSaveltem_Click. 


Observe el formulario de la figura anterior; muestra cuatro pedidos, de los 
cuales uno ya está servido. Para servir un pedido, el usuario de la aplicación hará 
clic en la fila correspondiente y después en Aceptar. ¿Qué tiene que ocurrir en es- 
te instante? Simplemente se actualizará la tabla pedidos de la base de datos con el 
nuevo valor del campo Servido: 


private void btAceptar_Click(object sender, EventArgs e) 
( 
if (pedidosBindingSource.Position < 0) return; 
int pos = pedidosBindingSource.Position; 
if (!ldsPedidos.pedidos[pos].Servido) 
{ 
dsPedidos.pedidos[pos].Servido = true; 
pedidosTableAdapter.Update(dsPedidos.pedidos); 
) 
else 
MessageBox.Show("Ese pedido ya fue servido"); 
Close(); 


EJERCICIOS PROPUESTOS 


1. Realizar otra versión de la aplicación ControlesEnlazadosADatos, utilizando aho- 
ra el control BindingNavigator en lugar de los botones que utilizábamos para 
desplazarnos por los registros de la tabla telefonos y de los que usábamos para 
añadir y borrar un registro. La interfaz que mostrará la aplicación será similar a la 
de la figura siguiente. Obsérvese que se ha añadido un botón a la barra de navega- 
ción para satisfacer la operación de buscar. 








aI BD teléfonos =|ll| x 
M 412 del4 |» >i | + X Hä 








Nombre: Isabella Ceballos Gor] Buscar 





Dirección: Boston, U.S.A. 





Buscar por: 
Teléfono 123456789 


Notas: La más grande 























2. Construya una base de datos para almacenar las notas de los alumnos matricula- 
dos en un determinado centro de unas determinadas asignaturas. 
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alumnos asignaturas 
Y id_alumno Y id_asignatura 
nombre nombre 










alums_asigs 
Y id_alumno 





Y ¡d_asignatura 


nota 


Después, realice una interfaz que permita a un alumno acceder a la base de 
datos para conocer la nota obtenida en cualquiera de las asignaturas en las que es- 
tá matriculado. La interfaz de la aplicación será similar a la siguiente: 


a Notas 





Isabella Dulce Bella 





LAB. DE PROGRAMACION AVANZADA 
LAB. DE FUNDAMENTOS DE PROGRAMACION 


PROGRAMACION AVANZADA p Pav 
PROGRAMACION VISUAL 





Nota: 7,5 


| 
(| 























A la vista de la interfaz anterior, el alumno seleccionará su nombre en la lista 
desplegable (este control muestra los nombres de la tabla alumnos) lo que hará 
que se muestren en la lista fija las asignaturas de las que está matriculado. Des- 
pués, seleccionará la asignatura de la cual quiere conocer la nota y esta le será 
mostrada en una caja de diálogo. Una posible forma de proceder sería la siguiente: 


e Crear la base de datos bd_notasAlumnos (puede utilizar un script localizado 
en la carpeta Cap13 del CD). 


e Añadir al formulario un SqlDataAdapter: sqldaAlumnos. Configurarlo para 
que devuelva la tabla alumnos. 


SELECT alumnos.* FROM alumnos 
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Crear un conjunto de datos dsAlumnos a partir de sqldaAlumnos. 


Añadir un ComboBox y vincularlo con dsAlumnos. Tiene que mostrar el 
nombre del alumno y guardar como valor el id_alumno. 


Llenar el conjunto de datos a partir de sg/da Alumnos. 


Añadir al formulario un SqlDataAdapter: sgldaAsignaturasNotas. Configu- 
rarlo para que devuelva asignaturas.nombre, alums asigs.nota y alums_ a- 
sigs.id_alumno correspondientes al alumno seleccionado. 


SELECT asignaturas.nombre, alums_asigs.nota, alums_asigs.id_alumno 

FROM alums_asigs, asignaturas 

WHERE  alums_asigs.id_asignatura = asignaturas.id_asignatura AND 
alums_asigs.id_alumno = IDA umno 


Crear un conjunto de datos dsAsignaturasNotas a partir de sgldaAsignaturas- 
Notas. 


Añadir un ListBox, /istaAsignaturasNotas, y vincularlo con dsAsignaturas- 
Notas. Tiene que mostrar las asignaturas del alumno seleccionado y guardar 
como valor la nota. 


Cada vez que se seleccione un alumno, llenar el conjunto de datos dsAsigna- 
turasNotas a partir de sqldaAsignaturasNotas en función del ID del alumno 


seleccionado. 


Cada vez que se seleccione una asignatura, mostrar la nota correspondiente. 
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LINQ 


LINQ (Language INtegrated Query) fue inicialmente soportado por .NET Fra- 
mework 3.0 con la finalidad de ofrecer la posibilidad de expresar las operaciones 
de consulta en el propio lenguaje (C#, por ejemplo) y no como literales de cadena 
pertenecientes a otro lenguaje incrustados en el código de aplicación o como pro- 
cedimientos almacenados. Finalmente, es con la versión 3.5 de .NET Framework, 
espacios de nombres System.Linq y System.Data.Linq, cuando LINQ queda total- 
mente integrado en este marco de trabajo, junto con otras bibliotecas como WPF, 
WCF, WF o ASP.NET AJAX, haciendo realidad la implementación de aplicacio- 
nes que contengan única y exclusivamente código .NET. 


RECURSOS DEL LENGUAJE COMPATIBLES CON LINQ 


LINQ es una combinación de extensiones al lenguaje y bibliotecas de código ad- 
ministrado que permite expresar de manera uniforme consultas sobre colecciones 
de datos de diversa procedencia utilizando recursos del propio lenguaje de pro- 
gramación; por ejemplo, sobre objetos en memoria, sobre bases de datos relacio- 
nales o sobre documentos XML, entre otros. Los elementos básicos sobre los que 
se construyeron estas nuevas extensiones son los siguientes: 


Declaración implícita de variables locales. 
Matrices de tipos definidos de forma implícita. 
Tipos anónimos. 

Propiedades autoimplementadas. 

Iniciadores de objetos y colecciones. 

Métodos extensores. 

Expresiones lambada. 

Operadores de consulta. 

Árboles de expresiones lambda. 


e A O 
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Estas características son la base para formar las expresiones de consulta, las 
cuales constituyen el principal reflejo en el lenguaje de la tecnología LINQ. 


Declaración implícita de variables locales 


Utilizando el identificador var es posible declarar una variable iniciada con un va- 
lor sin especificar su tipo. En este caso, el de la variable será tomado del tipo del 
valor con el que se inicia la misma. Por ejemplo: 


var e = 0; // equivale a inte = 0; 
Console.WriteLine(e.GetType().FullName); // imprime: System.Int32 


Tal práctica de esta característica va en contra de la claridad del código fuen- 
te, pero es verdaderamente potente cuando se utiliza en combinación con otras, 
como, por ejemplo, con los tipos anónimos. 


Matrices de tipos definidos de forma implícita 


Apoyándonos en lo expuesto en el apartado anterior, también es posible iniciar 
una matriz sin especificar explícitamente el tipo de los elementos, el cual será ob- 
tenido por C# a partir del tipo de los valores proporcionados. Por ejemplo: 


var m = new[] (1, 2, 3); // equivale a int[] m = (1, 2, 3); 


foreach (var a in m) 
Console.WriteLine(a); // imprime: 1 2 3 


Console.WriteLine(m.GetType().FullName); // imprime: System.Int32[1 


Tipos anónimos 


Es posible generar un tipo nuevo de datos a partir de expresiones de iniciación. 
Por ejemplo: 


var persona = new { Nombre = "Isabella", Edad = 1 }; 
Console.WriteLine(persona.Nombre); 
Console.WritelLine(persona.GetType().FullName); 


La primera sentencia del ejemplo anterior genera un tipo anónimo con los 
atributos especificados en su iniciación. Un tipo anónimo es una manera cómoda 
de agrupar temporalmente un conjunto de propiedades en un resultado de una 
consulta sin tener que definir un tipo con nombre independiente. 
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Propiedades autoimplementadas 


Una propiedad autoimplementada hace que la declaración de la misma sea más 
breve cuando no se requiere ninguna lógica adicional en los descriptores de acce- 
so de la propiedad. Al declarar una propiedad como se muestra en el ejemplo si- 
guiente, el compilador crea un atributo de respaldo privado y anónimo que no está 
accesible directamente. Por ejemplo: 


public string Nombre { get; set; ) 


La declaración de la propiedad Nombre anterior es equivalente a esta otra: 


private string _nombre; 
public string Nombre 
( 
get { return _nombre; } 
set [ _nombre = value; ) 


} 


El nivel de acceso en los descriptores puede ser diferente: 


public string DNI { get; private set; } 


Iniciadores de objetos y colecciones 


Los iniciadores de objeto y de colección permiten iniciar los objetos sin llamar 
explicitamente al constructor correspondiente del objeto. Los iniciadores suelen 
utilizarse en expresiones de consulta. Por ejemplo, supongamos que hemos defi- 
nido la clase CPersona así: 


public sealed class CPersona 
( 
public string Nombre { get; set; ) 
public DateTime FechaNac { get; set; ) 
) 


Partiendo de esta declaración es posible iniciar un objeto empleando la si- 
guiente construcción: 


var persona = new CPersona 
( 
Nombre = "Isabella", 
FechaNac = new DateTime(2011, 11, 7) 
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También podemos iniciar una colección, iniciando cada uno de sus elementos 
de la forma expuesta anteriormente: 


List<CPersona> listPersona = new List<CPersona»> { 
new CPersona { 
Nombre = "Isabella", FechaNac = new DateTime(2011, 11, 7) ), 
new CPersona { 
Nombre = "Manuel", FechaNac = new DateTime(1991, 7, 26)) 


Métodos extensores 


Los métodos extensores permiten extender o ampliar la funcionalidad de una clase 
sin recurrir a la herencia (técnica que en ocasiones es imposible, por ejemplo, si la 
clase ha sido calificada sealed) ni a la delegación (que requiere una implementa- 
ción más laboriosa). Como ejercicio, supongamos que deseamos ampliar la clase 
CPersona implementada en el párrafo anterior, por ejemplo, para conocer la edad 
que tiene una determinada persona. La solución pasaría por escribir una clase sta- 
tic, en el ejemplo CPersonaEx, con un método static, en este caso Edad, con un 
primer parámetro precedido por el modificador this: 


public static class CPersonaEx 

( 
public static int Edad(this CPersona persona) 
( 


int edad = DatelTime.Today.Year - persona.FechaNac.Year; 





if (DateTime.Today.Month > persona.FechaNac.Month || 
DateTime.Today.Month == persona.FechaNac.Month 22 
DatelTime.Today.Day >= persona.FechaNac.Day) 
return edad; 
return edad - 1; 














El modificador this es quien indica que se trata de un método extensor (el 
nombre de la clase puede ser cualquiera) y solo se permite en el primer parámetro, 
de un método static, que debe ser del tipo de la clase que se desea ampliar; en 
nuestro caso, del tipo CPersona. 


Si ahora modificamos el ejemplo que hicimos en el apartado anterior para que 
un elemento de la lista llame al método extensor, podremos observar que su com- 
portamiento es como si fuera un método nativo de CPersona. 


public sealed class CPersona 


( 
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2! 
) 


class Test 
( 
public static void Mainístringl] args) 
( 
List<CPersona> listPersona = new List<CPersona»> { 
new CPersona { 
Nombre = "Isabella", FechaNac = new Datelime(2011, 11, 7) ), 
new CPersona { 
Nombre = "Manuel", FechaNac = new DateTime(1991, 9, 21)) 





jis 


Console.WriteLine(listPersona[1].Edad()); 
) 
) 


Los métodos extensores en la resolución de llamadas por parte del compilador 
tienen menor resolución que los métodos nativos; esto es, si la clase CPersona tu- 
viera un método nativo Edad, se utilizaría este. 


Expresiones lambda 


Las expresiones lambda, un recurso tradicional en los lenguajes de programación 
funcional, pueden transformarse en tipos de delegados para la generación y poste- 
rior ejecución de código. Esto es, pueden reemplazar de una manera más concisa a 
los métodos anónimos: bloques de código que pueden colocarse inline en aquellos 
sitios donde el compilador espera encontrarse un delegado. La sintaxis de estas 
expresiones es la siguiente: 


(Jista de parámetros) => expresión|bloque de sentencias 


La lista de parámetros, separados por comas, irá entre paréntesis (estos pue- 
den omitirse cuando se trate de un único parámetro). A continuación se escribe el 
símbolo de implicación y después, la expresión o bloque de sentencias a ejecutar, 
tomando como argumentos esos parámetros. El operador => tiene la misma prio- 
ridad que la asignación (=) y es asociativo por la derecha. Ejemplos: 








a= a 2 // expresión; tipo implícito 
Cinta > a $2 // expresión; tipo explícito 
a => { return a * 2; ) // sentencia; tipo implícito 
(int a) => [ return a * 2; ) // sentencia; tipo explícito 
Cas. DJ. =>. + b // varios parámetros 

() => Console.Writeline() // sin parámetros 

(string s, int x) => s.Length > x // varios parámetros con tipo 
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Cuando el compilador no pueda deducir los tipos de entrada, habrá que espe- 
cificarlos explícitamente, como ocurre en el último ejemplo. 


El cuerpo de una expresión lambda puede estar compuesto por cualquier nú- 
mero de sentencias, pero generalmente este número es muy pequeño. 


public delegate void Suma(double x, double y); 

11 

Suma deSuma = (a, b) => { var s =a + b; Console.Writeline(s); ); 
deSuma(5, 6.5); // imprime: 11,5 


Como ejemplo, vamos a añadir a la clase CPersona un método NacidoAño 
que muestre las personas de una lista que hayan nacido en un año determinado. El 
primer argumento de este método será una referencia a la lista de personas y el 
segundo, un delegado que ejecutará la expresión condicional necesaria. 


// Delegado 
public delegate bool ExprCondicional(CPersona pers); 


public sealed class CPersona 
( 
11 


public static void NacidosAño(List<CPersona> lista, 
ExprCondicional condición) 
( 
foreach (CPersona p in lista) 
( 
if (condición(p)) 
Console.WriteLine(p.Nombre); 


) 
) 


class Test 
( 
public static void Mainístringl] args) 
( 
List<CPersona> listPersona = new List<CPersona»> { 
new CPersona { 
Nombre = "Isabella", FechaNac = new DateTime(2011, 11, 7) ), 
new CPersona { 
Nombre = "Manuel", FechaNac = new DateTime(1991, 9, 21)) 





je 


CPersona.NacidosAño(listPersona, delegate (CPersona p) { 
recurra pp recnalac. Vel = OE 
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La llamada a NacidosAño desde Test incluye en su segundo argumento un 
método anónimo. Reemplacemos este método por una expresión lambda: 


CPersona.NacidosAño(listPersona, 


(CPersona p) => p.FechaNac.Year == 1991); 


o bien, 


CPersona.NacidosAño(listPersona, (p) => p.FechaNac.Vear == 1991); 


El tipo de p se deduce de la definición del delegado. A modo de resumen, po- 
demos deducir que las expresiones lambda comparadas con los métodos anóni- 
mos tienen las siguientes ventajas: notación más concisa, expresiva y funcional; 
permiten definir los parámetros de forma implícita; el cuerpo puede ser una ex- 
presión o un bloque de sentencias; y pueden almacenarse en memoria como árbo- 
les de expresiones, concepto que estudiamos un poco más adelante. 


El delegado Func<7, TResu> 


El delegado Func utiliza parámetros de tipo: 


public delegate TResult Func<T,..., TResult>(T arg,...); 


El valor devuelto siempre se corresponde con el parámetro especificado en el 
último lugar; el resto son parámetros de entrada. Por ejemplo, el siguiente código 
define un delegado Func que, cuando se invoca, devuelve verdadero o falso para 
indicar si el parámetro de entrada es un número par: 


Func<int, bool» esPar = n => n % 2 = Q; 
bool resultado = esPar(11); // retorna false 


Según lo expuesto, en el ejemplo del apartado anterior podemos prescindir del 
delegado ExprCondicional y modificar el método NacidosAño para que utilice un 
delegado Func: 


public static void NacidosAño(List<CPersona> lista, 


Func<CPersona, boo1> condición) 


foreach (CPersona p in lista) 
( 
if (condición(p)) 
Console.WriteLine(p.Nombre); 


( 


638 ENCICLOPEDIA DE MICROSOFT VISUAL CH 


La llamada a este método sería idéntica a la del ejemplo anterior: 


CPersona.NacidosAño(listPersona, (p) => p.FechaNac.Year == 1991); 


También, podríamos prescindir del método NacidosAño y utilizar un delegado 
Func con dos parámetros de entrada (el tercero es el tipo del valor devuelto): 


Func<CPersona, int, bool> esNacidoEnAño = 
(p, año) => p.FechaNac.Year == año; 
foreach (CPersona p in listPersona) 
( 
if (esNacidoEnAño(p, 1991)) 
Console.WriteLine(p.Nombre); 


Operadores de consulta 

Los operadores de consulta son los métodos que forman el modelo de LINQ. In- 

cluyen operaciones de filtrado, proyección, agregación, ordenación y otras. Algu- 

nos de ellos son (se indica, entre paréntesis, la palabra clave C# si existe, utilizada 
en las expresiones de consulta que veremos más adelante): 

e Select (select). Proyecta valores basados en una función de transformación. 

e SelectMany (utilizar varias cláusulas from). Proyecta secuencias de valores 
basados en una función de transformación y, a continuación, los condensa en 
una sola secuencia (un enumerable). 

e Where (where). Selecciona valores basados en una función de predicado. 


e  OrderBy (orderby). Ordena los valores de forma ascendente. 


e Join (join ... in ... on ... equals ...). Combina dos secuencias según las fun- 
ciones del selector de claves y extrae pares de valores. 


e GroupBy (group ... by). Agrupa los elementos que comparten un atributo 
común. Cada grupo se representa mediante un objeto IGrouping<7Key, T>. 


e Count. Cuenta los elementos de una colección y, opcionalmente, solo aque- 
llos que satisfacen una función de predicado. 


e Max. Determina el valor máximo de una colección. 


e Min. Determina el valor mínimo de una colección. 
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e Sum. Calcula la suma de los valores de una colección. 


e TakeWhile. Devuelve los elementos de una colección mientras que el valor 
de la condición especificada sea true. 


Puede ver un listado completo de todos los operadores de consulta en un lis- 
tado proporcionado en la ayuda de Visual Studio. 


La mayoría de estos métodos funcionan sobre objetos cuyo tipo implementa 
la interfaz IEnumerable<7> (interfaz que proporciona iteración simple en una 
colección de un tipo especificado) o la interfaz IQueryable<7> (interfaz para 
evaluar consultas con respecto a un origen de datos; hereda de IEnumera- 
ble<7>). Se definen como métodos extensores del tipo sobre el que operan. Esto 
significa que pueden ser llamados utilizando la sintaxis del método estático (o de 
clase) o la sintaxis del método de un objeto (o instancia). 


Muchos operadores de consulta tienen un parámetro de entrada de tipo Func. 
Según esto, veamos un ejemplo de cómo se utiliza uno de estos operadores de 
consulta, por ejemplo, Count: 


int[] números = [ 6, 7, 11, 9, 8, 5, 4, 1, 3,2); 
int númerosPares = números.Countín => n % 2 == 0); // resultado: 4 


Compare el argumento pasado con el segundo parámetro del método Nacidos- 
Año del ejemplo anterior: ambos son de tipo Func. La expresión lambda utilizada 
cuenta aquellos enteros (n) que divididos por 2 dan como resto 0. Observe tam- 
bién que el compilador puede deducir el tipo del parámetro de entrada; también se 
puede especificar explícitamente como en el ejemplo siguiente. 


El método siguiente generará una secuencia que contiene todos los elementos 
de la matriz de números que aparecen antes del 11 menores que 9 (6 y 7), ya que 
11 es el primer número de la secuencia que no cumple la condición: 


int[] números = { 6, 7, M, 9, 8, 5, 4, 1, 3,2); 
var primerosNumsMenoresQue9 = números.TakeWhile((int n) => n < 9); 


Las llamadas a los métodos de consulta se pueden encadenar en una sola con- 
sulta, lo que permite hacer consultas bastante complejas. Además, según vimos 
anteriormente, algunos de los operadores de consulta más frecuentemente utiliza- 
dos poseen una sintaxis de palabras clave específicas del lenguaje CH que les 
permite ser llamados como parte de una expresión de consulta. Por ejemplo: 


var numsImparesOrdenados = // resultado: 1, 3, 5, 7, 9, 11 
from n in números 
where (n % 2 != 0) 
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orderby n 
select n; 


Una expresión de consulta constituye una forma diferente de expresar una 
consulta, más legible que su equivalente basada en métodos. Las cláusulas de las 
expresiones de consulta se traducen en llamadas a los métodos de consulta en 
tiempo de compilación. Por ejemplo, la consulta anterior utilizando llamadas a 
métodos podría realizarse así: 


var numsImparesOrdenados = números.Whereín => n % 2 != 0).0rderBy( 
n => n).Select (n => n); 


O, de una forma más cercana a la expresión de consulta anterior, así: 


var numsImparesOrdenados 
Whereín => n % 2 
OrderByín => n). 
Selectín => n); 


En esta otra versión observamos claramente tipos anónimos, expresiones 
lambda, etc., como base de la expresión de consulta, cuestión que ya indicamos 
anteriormente. 


Árboles de expresiones lambda 


Los árboles de expresiones lambda permiten representar expresiones lambda co- 
mo estructuras de datos en lugar de como código ejecutable. Esto es, las expresio- 
nes lambda pueden transformarse en árboles de expresiones para su posterior 
manipulación, almacenamiento o transmisión. Por ejemplo, la expresión a + b *c 
podemos verla bajo la siguiente estructura en la que los datos se almacenan en 
forma de árbol (el lector puede reconstruir la expresión recorriendo el árbol de la 
figura en in-orden): 


raíz 


Árbol de expresión 
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Cuando una expresión lambda está asignada a una variable de tipo Expres- 
sion<7 Delegado>, por ejemplo Expression<Fune>, el compilador emite un árbol 
de expresión que representa dicha expresión lambda. Por ejemplo, algunos opera- 
dores de consulta que se definen en la clase Queryable tienen parámetros de tipo 
Expression<7Delegado>. Entonces, cuando se llama a estos métodos, la lambda 
pasada como argumento se compilará produciendo un árbol de expresión. 


En LINQ, los árboles de expresiones lambda se utilizan para representar con- 
sultas estructuradas para orígenes de datos que implementan IQueryable<7>. Por 
ejemplo, el proveedor LINO to SOL implementa esta interfaz para realizar consul- 
tas en almacenes de datos relacionales. Por lo tanto, según hemos explicado en el 
párrafo anterior, el compilador C# compilará las consultas destinadas a esos orí- 
genes de datos generando un árbol de expresión. Entonces, el proveedor de la 
consulta podrá recorrer el árbol de expresión y traducirlo en un lenguaje de con- 
sulta apropiado para el origen de datos. 


{ a Expression Tree Viewer lol E] 


=> (p.FechaNac.Year == 1991) a 











E l Bpression<Func<CPersona, Boolean>>| <Func<CPersona, Boolean>> a 


Type : Type : "Func<CPersona, Boolean>" m 
NodeType : Expression Type : "Lambda" | 
Parameters : ReadOnlyCollection<ParameterExpression> : "System.Runtime CompilerSen| 
Name : String : null 
E- Body : ExpressionEqual 
B- LogicalBinaryExpression 
Type : Type : "Boolean" 
Node Type : Expression Type : "Equal" 
CanReduce : Boolean : "False" 
E- Right : ExpressionConstant 
EJ Constant Expression 
Type : Type : "Int32" 
Node Type : Expression Type : "Constant" 
Value : Object : "1991" 
CanReduce : Boolean : "False" 
E- Left : ExpressionMemberAccess 
E- PropertyExpression 
Type : Type : "Int32" 
Member : Memberinfo : "Int32 Year" 
E- Boression : Expression MemberAccess 
È- PropertyExpression 
Type : Type : "Date Time" 
Member : Memberinfo : "System.Date Time FechaNac” 
B- Expression : ExpressionParameter 
B- TypedParameterExpression 
Type : Type : "CPersona” 
Node Type : Expression Type : "Parameter" 
Name : String : "p" 
IsByRef : Boolean : "False" 
CanReduce : Boolean : "False" 
Node Type : Expression Type : "MemberAccess” 
CanReduce : Boolean : "False" 
Node Type : Expression Type : "MemberAccess" 
CanReduce : Boolean : "False" 
Method : Methodinfo : null 
Conversion : Lambda Expression : null 
islífted : Boolean : "False" 
IsLittedToNull : Boolean : "False" 
Retum Type : Type : "Boolean" 
TailCall : Boolean : "False" 
CanReduce : Boolean : "False" Sé 
4 m + 


m 
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¿Cómo se ejecuta un árbol de expresión? Sólo se pueden ejecutar los árboles 
de expresiones que representen expresiones lambda, los cuales son de tipo Ex- 
pression<7Delegado> (por ejemplo, Expression<Func<CPersona, bool>>) o 
LambdaExpression. Para ejecutar un árbol de expresión primero hay que compi- 
larlo invocando a su método Compile con el fin de crear un delegado ejecutable y 
después hay que invocar al delegado para que se ejecute. 


El ejemplo siguiente asigna una expresión lambda a la variable exprNacido- 
EnAño de tipo Expression<Func<CPersona, bool>> a partir de la cual el compi- 
lador generará un árbol de expresión lambda con la finalidad de obtener de una 
lista de personas las que han nacido en un año determinado. 


string personas1991 = 
Expression<Func<CPersona, bool>> exprNacidoEnAño = 
(p) => p.FechaNac.Year == 1991; 


mamo 
, 


foreach (CPersona p in listPersona) 
( 
bool esNacidoEn = exprNacidoEnAño.Compile().Invoke(p); 
if (esNacidoEn) 
personas1991 += p.Nombre + Environment.NewLine; 


La figura anterior muestra el árbol de expresión lambda generado a partir de 
la variable exprNacidoEnAño a la que hemos asignado el valor: 


(p) => p.FechaNac.Year == 1991 


Los árboles de expresiones son útiles para crear consultas dinámicas de LINQ 
necesarias cuando no se conocen los detalles de la consulta durante la compila- 
ción; por ejemplo, porque sea necesario especificar durante la ejecución uno o 
más predicados para filtrar los datos que se desea obtener, lo que implica crear la 
consulta durante la ejecución. Pues bien, para crear los árboles de expresiones 
tendremos que utilizar la funcionalidad proporcionada por las clases del espacio 
de nombres System.Linq.Expressions. Por ejemplo, haciendo uso de esta fun- 
cionalidad, ¿cómo crearíamos el árbol de expresión de la figura anterior? El códi- 
go siguiente es la respuesta a esta pregunta (el código siguiente reconstruye la 
expresión recorriendo el árbol en postorden): 


// (p) => p.FechaNac.Year == 1991; 

ParameterExpression parametro_p = 
Expression.Parameter(typeof(CPersona), "p"); 

emberExpression m1 = Expression.Property(parametro_p, "FechaNac”); 

emberExpression left = Expression.Propertyíml, "Year"); 

ConstantExpression right = Expression.Constant(1991, typeof(int)); 

BinaryExpression exprb = Expression.Equal(left, right); 

Expression<Func<CPersona, bool>»> exprNacidoEnAño = 
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Expression.Lambda<Func<CPersona, bool>>( 
exprb, 
new ParameterExpression[] { parametro_p )); 


Y si en lugar de utilizar en la expresión lambda una constante (1991) utiliza- 
mos una variable año, la solución sería esta otra: 


int añoNac = 1991; 
// (p, año) => p.FechaNac.Year == año; 
ParameterExpression parametro_p = 
Expression.Parameter(typeof(CPersona), "p"); 
emberExpression ml = Expression.Property(parametro_p, "FechaNac"); 
emberExpression left = Expression.Propertyí(ml, "Year"); 
ParameterExpression right = Expression.Parameter(typeof(int), "año"); 
// right = parámetro año 
BinaryExpression exprb = Expression.Equal(left, right); 
Expression<Func<CPersona, int, bool>»> exprNacidoEnAño = 
Expression.Lambda<Func<CPersona, int, bool>>( 
exprb, 
new ParameterExpressionL] { parametro_p, right )); 

















foreach (CPersona p in listPersona) 


( 
if (exprNacidoEnAño.Compile().Invoke(p, añoNac)) 
personas1991 += p.Nombre + Environment.NewLine; 


La clase Expression proporciona la funcionalidad necesaria para crear nodos 
del árbol de expresión de tipos especificos; por ejemplo, un objeto Parameter- 
Expression, que representa una expresión de parámetro con nombre, un objeto 
MemberExpression, que representa un acceso a un campo o propiedad, un objeto 
ConstantExpression, que representa una expresión que tiene un valor constante, 
un objeto MethodCallExpression, que representa una llamada a un método, un 
objeto ConditionalExpression, que representa una expresión que tiene un opera- 
dor condicional, un objeto BinaryExpression, que representa una expresión que 
tiene un operador binario, o un objeto LambdaExpression, que describe una ex- 
presión lambda; todos definidos en el espacio de nombres System.Linq.Ex- 
pressions. Estas clases se derivan de la clase abstracta Expression. 


EXPRESIONES DE CONSULTA 


Al principio de este tema dijimos que LINQ es una combinación de extensiones al 
lenguaje y bibliotecas de código administrado que permite expresar de manera 
uniforme “consultas” sobre colecciones de datos de diversa procedencia (objetos 
en memoria, bases de datos relacionales o documentos XML) utilizando recursos 
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del propio lenguaje de programación. Estas consultas son llevadas a cabo median- 
te lo que se denomina expresiones de consulta. 


Por lo tanto, las expresiones de consulta responden a una nueva sintaxis que 
se ha añadido al lenguaje C# (y a Visual Basic) y pueden actuar sobre objetos que 
implementen la interfaz IEnumerable<7> o IQueryable<7>, entre los que se in- 
cluyen las matrices, transformándolos mediante un conjunto de operaciones en 
otras colecciones que implementen la misma interfaz. 


Para explicar con más claridad las expresiones de consulta, supongamos que 
hemos definido las clases CPais y CPersona asi: 


public sealed class CPais 

public string Codigo { get; set; ) 
public string Nombre { get; set; ) 
public sealed class CPersona 

public string Nombre { get; set; ) 


public DateTime FechaNac { get; set; ) 
public string PaisNac { get; set; ) 








Desde el punto de vista de LINQ, una consulta no es más que una expresión 
que recupera datos de un origen de datos. Todas las operaciones de consulta 
LINQ se componen de tres acciones distintas: 


1. Obtención del origen de datos. Por ejemplo: 


List<CPersona> listPersona = new List<CPersona> { 

new CPersona { 

Nombre = "Isabella", FechaNac = new DateTime(2011, 11, 7), PaisNac = "US" }, 
new CPersona { 

Nombre = "Manuel", FechaNac = new DateTime(1991, 9, 21), PaisNac = "ES"), 
new CPersona { 

Nombre = "Javier", FechaNac 
new CPersona { 

Nombre = "María", FechaNac = new DateTime(1991, 9, 1), PaisNac = "EN") 
h; 


new DateTime(1990, 7, 2), PaisNac = "ES" }, 














2. Creación de la consulta. Por ejemplo: 


var personas1990 = 
from p in listPersona 
where p.FechaNac.Year == 1990 
orderby p.Nombre 
select new { Nombre = p.Nombre }; 
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3. Ejecución de la consulta. En LINQ, la variable de consulta (personas1990 en 
nuestro caso) no realiza ninguna acción y no devuelve datos; solamente alma- 
cena la información de la consulta. Tras crear una consulta debe ejecutarla pa- 
ra recuperar los datos, por ejemplo, en una instrucción foreach: 


foreach (var persona in personas1990) 
Console.WriteLine(persona.Nombre); 


En el ejemplo siguiente se muestra cómo se expresan las tres partes de una 
operación de consulta en una aplicación concreta. En este ejemplo se utiliza por 
comodidad una matriz de objetos como origen de datos, pero los mismos concep- 
tos se aplican a otros orígenes de datos. En dicho ejemplo, se realiza una consulta 
sobre la colección List que hemos venido utilizando en los ejemplos anteriores, 
con el fin de obtener la colección de personas nacidas en un año determinado: 


using System; 

using System.Collections.Generic; 
using System.Linq; 

using System. Text; 


public sealed class CPais 
( 
public string Codigo { get; set; } 
public string Nombre { get; set; } 


public sealed class CPersona 








public string Nombre { get; set; } 
public DateTime FechaNac { get; set; } 
public string PaisNac { get; set; } 


} 


class Test 


( 

















public static void Mainístringl] args) 
( 
List<CPais> listPais = new List<CPais> { 
new CPais [ 
Codigo = "ES", Nombre = "España" }, 
new CPais { 
Codigo = "EN", Nombre = "Inglaterra" }, 
new CPais { 
Codigo = "FR", Nombre = "Francia" }, 
new CPais { 
Codigo = "US", Nombre = "Estados Unidos" }, 
y 
List<CPersona> listPersona = new List<CPersona> { 
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ew CPersona { 
ombre = "Isabella", FechaNac = new DateTime(2011, 11, 7), 
PaisNac = "US" }, 
ew CPersona { 
bre = "Manuel", FechaNac = new DateTime(1991, 9, 21), 
PaisNac = "ES"}, 
ew CPersona { 
bre = "Javier", FechaNac = new DateTime(1990, 7, 2), 
PaisNac = "ES" }, 
ew CPersona { 
ombre = "María", FechaNac = new DateTime(1991, 9, 1), 
PaisNac = "EN"} 














Yo 


// Expresión de consulta 
var personas1990 = 
from p in listPersona 
where p.FechaNac.Year == 1990 
orderby p.Nombre 
select new { Nombre = p.Nombre }; 


foreach (var persona in personas1990) 
Console.WriteLine(persona.Nombre):; 


Observemos la expresión de consulta (código sombreado). A cualquiera que 
esté familiarizado con la sentencia SELECT de SQL, le habrá resultado fácil en- 
tender dicha expresión. Quizás nos sorprenda que la cláusula select no esté al 
principio. La razón es que si estuviera al principio sería imposible ofrecer la ayu- 
da inteligente a la hora de escribir la expresión de consulta, porque aún no se ha- 
bría especificado la colección de objetos sobre los que se ejecutará la consulta. 
Esto es, si listPersona es de tipo List<CPersona> (List implementa la interfaz 
IEnumerable), entonces se deduce que p es de tipo CPersona, con lo que el sis- 
tema podrá verificar la sintaxis cuando a continuación escribamos el resto de las 
cláusulas. 


La consulta del ejemplo anterior devuelve todos los nombres de la lista /ist- 
Persona (objeto List) de objetos CPersona cuya fecha de nacimiento sea 1990 
ordenados ascendentemente. Contiene cuatro cláusulas: from, where, orderby y 
select. La cláusula from especifica el origen de datos y una variable local que re- 
presenta cada elemento en la secuencia de origen, la cláusula where aplica el fil- 
tro (se pueden utilizar operadores lógicos), la cláusula orderby ordena el 
resultado ateniéndose al dato especificado y la cláusula select especifica el tipo de 
los elementos devueltos. No olvide que definir la variable de consulta no realiza 
ninguna acción ni devuelve datos, simplemente almacena la información necesa- 
ria para generar los resultados cuando la consulta se ejecute posteriormente. 
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El ejemplo anterior podría también haberse escrito así: 


var personas1990 = 
from p in listPersona 
where p.FechaNac.Year == 1990 
orderby p.Nombre 
select p; 


foreach (var persona in personas1990) 
Console.WriteLine(persona.Nombre); 


¿Cuál es la diferencia? En el ejemplo anterior, personas1990 era una colec- 
ción de objetos de tipo anónimo con una propiedad Nombre de tipo string de solo 
lectura, y en este, personas1990 es una colección de objetos CPersona con pro- 
piedades de lectura y escritura. 


Compilación de una expresión de consulta 


Cuando el compilador encuentra una expresión de consulta la transforma en una 
consulta compuesta formada por llamadas a métodos. Por ejemplo: 


var personas1990 = listPersona. 
Where(p => p.FechaNac.Year == 1990). 
OrderBy(p => p.Nombre). 
Selectí(p => new { Nombre = p.Nombre } ); 


En el código anterior observamos llamadas a los métodos Where, OrderBy y 
Select. Observemos la firma de uno de ellos: 


public static IEnumerable<TOrigen> Where<TOrigen>( 
this IEnumerable<TOrigen> origen, 
Func<TOrigen, bool> predicado 


Se trata de un método extensor, como ya habíamos estudiado anteriormente, 
que, por definición, se puede invocar como un método estático (se ha declarado 
static) o como un método de un objeto (es una extensión a los métodos del tipo 
TEnumerable). El primer parámetro precedido por this hace referencia al tipo ex- 
tendido, en este caso al tipo IEnumerable ya que hemos partido de que los obje- 
tos sobre los que operarán las expresiones de consulta tienen que implementar 
esta interfaz, y el segundo, el predicado (el filtro), es un delegado que hace refe- 
rencia a un método que recibirá como argumento un objeto de tipo TOrigen y de- 
volverá un valor de tipo bool. La función lambda es la que se transformará en ese 
delegado anónimo. 
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¿Por qué estos métodos se han implementado como métodos extensores? Pues 
para que LINQ sea una arquitectura abierta y extensible. Según esto, añadir nues- 
tro propio método Where es tan sencillo, según explicamos anteriormente en el 
apartado Métodos extensores, como añadir a nuestra aplicación una clase static 
con un método static con un primer parámetro precedido por el modificador this. 
Por ejemplo, añadamos a la aplicación anterior la siguiente clase para extender el 
tipo IEnumerable con el siguiente método Where: 


using System; 
using System.Collections.Generic; 


public static class CEnumerableEx 
( 
public static IEnumerable<T> Where<T>( 
this IEnumerable<T> origen, 
Func<T, bool> predicado) 
( 
foreach (T p in origen) 
if (predicado(p)) { yield return p; ) 


Si compila y ejecuta ahora la aplicación, observará que al ejecutarse la con- 
sulta, el método Where invocado es este que hemos añadido. Precisamente en es- 
to consiste la arquitectura abierta de LINQ: cualquiera puede añadir otros 
operadores de consulta siempre que cumplan con las firmas que exige el compila- 
dor. Precisamente esta ha sido la vía a través de la cual se han integrado en el len- 
guaje las extensiones LINQ. 


Obsérvese la construcción yield return, permite crear iteradores fácilmente 
saliendo y entrando en un bucle for. Para utilizar yield return, basta con escribir 
una función que devuelva un IEnumerable<7>. Esta función utilizará un bucle y 
yield return para devolver a quien la invocó esos elementos que coinciden con el 
criterio especificado. Literalmente, yield return elimina la necesidad de crear un 
objeto de la clase de colección que tiene que devolver, llenar esa colección y de- 
volverla; resumiendo, no tenemos que copiar un montón de objetos una vez más. 
Puede probarlo ejecutando paso a paso el ejemplo siguiente. Observará que, en 
lugar de crearse un IEnumerable<7>, yield return devuelve, en este caso a 
Main, cada elemento que tendría que añadir a la colección, a petición del bucle 
foreach de Main. 


class Program 
( 
public static IEnumerable<int> Enteros() 
( 
for Cint Tes 03 7 LOS +41) 
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yield return 1; 


) 


static void Mainístring[] args) 


( 


foreach (int i in Enteros()) 
Console.WritelLine(1); 


La palabra clave yield también se utiliza con break para indicar el final de la 
iteración. 


Sintaxis de las expresiones de consulta 


Básicamente, una expresión de consulta siempre comienza con la cláusula from ... 
in, en la que se especifica una variable local que representa a cada elemento en la 
secuencia de origen, así como el origen de datos, y a continuación se pueden es- 
cribir una o más cláusulas from ... in, let, where, join ... in ... on ... equals, join 
.. in ... On ... equals ... into, orderby ... [ascending | descending], select, group 
.. by, o group ... by ... into. Opcionalmente, al final de la expresión puede escri- 
birse una cláusula de continuación que comienza con into y continúa con el cuer- 
po de otra consulta. 


Cláusula group 


La cláusula group permite agrupar los resultados según la clave que se especifi- 
que. Por ejemplo, la siguiente expresión de consulta genera una secuencia perso- 
nasPorAño con las personas de la lista listPersona agrupadas por años: 


var personasPorAño = 
from p in listPersona 
group p by p.FechaNac.Year; // Key: año 


foreach (var grupoPersonas in personasPorAño) 
( 
Console.WriteLine(grupoPersonas.Key); // año 
foreach (var persona in grupoPersonas) 
Console.WriteLine(" [0)", persona.Nombre):; 


El resultado es una secuencia de elementos de tipo IGrouping<7Key, T> (he- 
reda de IEnumerable<7>) que define una propiedad Key del tipo de la clave de 
agrupación, en nuestro caso de tipo int. 
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Este otro ejemplo, haciendo uso de la lista de países y de la de personas, 
agrupa las personas según su país de nacimiento: 


var personasPais = 
from pais in listPais 
join pers in listPersona 
on pais.Codigo equals pers.PaisNac 
group new [ Nombre = pers.Nombre } by pais.Nombre; 


foreach (var grupoPerPais in personasPais) 
( 
Console.WriteLine(grupoPerPais.Key); // nombre país 
foreach (var persona in grupoPerPais) 
Console.WritelLine(" [0)", persona.Nombre); 


} 
Productos cartesianos 


En bases de datos, el producto cartesiano de dos tablas no es más que otra tabla 
resultante de combinar cada fila de la primera con cada fila de la segunda. En 
LINQ podemos aplicar esta definición utilizando dos cláusulas from (un producto 
cartesiano se implementa mediante el método SelectMany). Por ejemplo: 


var productoCartesiano = 
from pais in listPais 
from pers in listPersona 
select new { NomPais = pais.Nombre, NomPers = pers.Nombre }; 


foreach (var elem in productoCartesiano) 
Console.WriteLine("{0} {1}", elem.NomPers, elem.NomPais ); 


Es recomendable evitar los productos cartesianos por la explosión combinato- 
ria que generan, o crearlos con restricciones. Por ejemplo, la siguiente expresión 
de consulta muestra el nombre de las personas junto con el país donde nacieron: 


var productoCartesiano = 
from pais in listPais 
from pers in listPersona 
where pais.Codigo == pers.PaisNac 
select new { NomPers = pers.Nombre, NomPais = pais.Nombre }; 


Cláusula join 


La cláusula join se utiliza para realizar una operación de combinación (join fun- 
ciona siempre con colecciones de objetos, en lugar de con tablas de base de datos, 
aunque en LINQ no es necesario utilizar esta cláusula tan a menudo como en 
SQL, porque las claves externas en LINQ se representan en el modelo de objetos 
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como propiedades que contienen una colección de elementos). Con join se trata 
de limitar las combinaciones que produciría un producto cartesiano, manteniendo 
únicamente los elementos de las secuencias que casan de acuerdo con el criterio 
establecido. Por ejemplo, la combinación que realizamos en el apartado anterior 
(producto cartesiano) podríamos escribirla mejor así, ya que el rendimiento es 
muy superior: 


var combinacion = 
from pais in listPais 
join pers in listPersona 
on pais.Codigo equals pers.PaisNac 
select new { NomPers = pers.Nombre, NomPais = pais.Nombre }; 


foreach (var elem in combinacion) 
Console.WritelLine("(0) (1)", elem.NomPers, elem.NomPais); 


Cláusula into 


La cláusula into puede utilizarse para crear un identificador temporal que almace- 
ne los resultados de una cláusula group, join o select en un nuevo identificador. 
Por ejemplo, la siguiente expresión de consulta genera una secuencia persNaci- 
dasPorAño con los años de nacimiento de las personas de la lista listPersona 
agrupadas por año de nacimiento más el número de personas de cada grupo, pero 
solo los grupos con un número mínimo de personas: 


var persNacidasPorAño = 
from p in listPersona 
group p by p.FechaNac.Year into grupoPersAño 
where grupoPersAño.Count() >= 2 
select new [ Año = grupoPersAño.Key, 
PorAño = grupoPersAño.Count() }; 


foreach (var personas in persNacidasPorAño) 

( 

Console.WriteLine("En (0) nacieron {1} o más personas.", 
personas.Año, personas.PorAño):; 





¿Recuerda el resultado de la expresión de consulta siguiente? 


var personasPais = 
from pais in listPais 
join pers in listPersona 
on pais.Codigo equals pers.PaisNac 
group new [ Nombre = pers.Nombre ) by pais.Nombre; 


Era este: 
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España 
Manuel 
Javier 
Inglaterra 
María 
Estados Unidos 
Isabella 


¿Cómo modificamos la expresión de consulta para que los países aparezcan 
en orden ascendente? Pues introduciendo ese resultado en una secuencia y orde- 
nando esta. Para ello utilizaremos into con group. Esto es: 


var persPais = 
from pais in listPais 
join pers in listPersona 
on pais.Codigo equals pers.PaisNac 
group new [ Nombre = pers.Nombre ) 
by pais.Nombre 


Otro ejemplo. ¿Cómo obtenemos una lista de países ordenada ascendente- 
mente con el número de personas por país? Combinamos cada país con las perso- 
nas de ese país y las contamos. Para ello utilizaremos into con join. Esto es: 


var PaisNumPers = 
from pais in listPais orderby pais.Nombre 
join pers in listPersona 
on pais.Codigo equals pers.PaisNac 
into grupoPais 
select new { NomPais = pais.Nombre, NumPers = grupoPais.Count() 
js 
foreach (var pais in PaisNumPers) 
( 
string s = pais.NumPers == 1 ? "persona" : "personas"; 
Console.WriteLine("En (0) hay (1) (2).", 
pais.NomPais, pais.NumPers, s); 





Cláusula let 


La cláusula let se utiliza para almacenar el resultado de una subexpresión con el 
fin de utilizarlo en cláusulas posteriores. Por ejemplo, la siguiente expresión de 
consulta, haciendo uso de la cláusula let, genera una secuencia persPorAñoMes 
con las personas que han nacido en un mes y un año determinados: 


int unMes = 9, unAño = 1991; 
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var persPaisAñoMes = 
from pais in listPais orderby pais.Nombre 
join pers in listPersona 
on pais.Codigo equals pers.PaisNac 
let mesNac = pers.FechaNac.Month 
let añoNac = pers.FechaNac.Year 
where añoNac == unAño 88 mesNac == unMes 
group new [ Nombre = pers.Nombre } by pais.Nombre into perPais 
select perPais; 


Console.Writeline("Nacidos en el mes (0) del año (1): 
foreach (var grupoPerPais in persPaisAñoMes) 
( 


, unMes, unAño); 





Console.WriteLine(grupoPerPais.Key):; 
foreach (var persona in grupoPerPais) 
Console.WritelLine(" [0)", persona.Nombre); 


PROVEEDORES DE LINQ 


En LINQ distinguimos proveedores locales y proveedores remotos. Los proveedo- 
res locales son aquellos que operan sobre objetos en memoria (es lo que hemos 
estado haciendo en los ejemplos anteriores). Estos objetos tienen que implementar 
la interfaz IEnumerable<7>. A esta categoría pertenecen LINO to Objects (el 
proveedor que hemos venido utilizando hasta ahora), LINO to DataSet y LINO to 
XML. Y los proveedores remotos son aquellos que operan sobre bases de datos re- 
lacionales. En este caso, el mecanismo basado en el recorrido de colecciones de 
objetos en memoria (más bien secuencias), que tan bien nos ha funcionado en los 
proveedores locales, no resulta adecuado en los proveedores remotos, simplemen- 
te porque cualquier implementación de un operador de consulta basada en la na- 
vegación de cursores (un cursor puede verse como un iterador sobre la colección 
de filas de un conjunto de datos obtenido después de una consulta SQL) sería un 
fracaso desde el punto de vista de rendimiento. Debido a esto, se definió la inter- 
faz IQueryable<7>, que hereda de IEnumerable<7>, que es la que implementan 
los proveedores LINO to SOL y LINO to Entities. Quiere esto decir que los obje- 
tos que implementen la interfaz IQueryable<7> pueden ser también orígenes de 
consultas integradas, pero lo que verdaderamente aporta esta interfaz es un con- 
junto de métodos extensores con una implementación más adecuada para interac- 
cionar con bases de datos relacionales que la proporcionada por los métodos de 
LINO to Objects. 


Centrándonos ya en los proveedores LINO to Objects y LINO to SOL/Entities, 
podemos decir que ambos proporcionan prácticamente los mismos operadores de 
consulta. La diferencia está en que los métodos extensores de LINO to 
SOL/Entities, en lugar de recibir delegados como parámetros, reciben árboles de 
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expresiones. No obstante, esto no es un problema ya que, según vimos anterior- 
mente en este mismo capítulo, una expresión lambda puede transformarse en un 
delegado y también en un árbol de expresión. 


Todos los métodos incorporan una referencia a un árbol de expresión que de- 
fine el algoritmo de obtención de la secuencia. Como ejemplo, observe la firma 
del método Where aportado por la interfaz IQueryable<7> y compárelo con la 
que vimos anteriormente: 


public static IQueryable<TOrigen> Where<TOrigen>( 
this IQueryable<TOrigen> origen, 
Expression<Func<TOrigen, bool>> predicado 


Observamos que este método tiene al menos un parámetro de tipo Expres- 
sion<7Delegado> cuyo argumento de tipo es un delegado Func. Por lo tanto, es 
posible pasar una expresión lambda y compilarla en un objeto Expres- 
sion<7Delegado>. Finalmente, la consulta que se obtiene como resultado de eje- 
cutar un árbol de expresión que representa al método Where que realiza la 
llamada devolverá los elementos de origen que satisfagan la condición especifica- 
da en predicado. 


Lo explicado para el método Where puede aplicarse a otros métodos. 


ENTITY FRAMEWORK 


ADO.NET Entity Framework permite a los desarrolladores crear aplicaciones que 
acceden a bases de datos elevando el nivel de abstracción, del nivel lógico rela- 
cional al nivel conceptual. En este nivel de abstracción superior, Entity Frame- 
work admite código que es independiente de cualquier motor de almacenamiento 
de datos o esquema relacional determinados. Pues bien, utilizando LINQ, concre- 
tamente el proveedor LINO to Entities, es posible consultar las entidades que de- 
finen el modelo conceptual de Entity Framework. 


Para ello, durante el diseño de la aplicación, asignaremos el modelo de datos 
relacional de una base de datos a un modelo de objetos expresado en el lenguaje 
de programación del programador, para después realizar las consultas sobre el 
modelo de objetos. Estas consultas serán convertidas por Entity Framework a 
SQL y enviadas a la base de datos para su ejecución. Cuando la base de datos de- 
vuelva los resultados, Entity Framework los vuelve a convertir en objetos expre- 
sados en el propio lenguaje de programación utilizado. 


Hay una gran diferencia entre Entity Framework y LINQ. LINQ es un lengua- 
je de consulta integrado que se puede ejecutar sobre varias fuentes por medio de 
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los distintos proveedores de LINQ desarrollados hasta la fecha. Estas fuentes y los 
proveedores correspondientes son: 


DataSet: LINO to DataSet. 

XML: LINO to XML. 

Objetos de memoria: LINO to Objects. 

Bases de datos relacionales: LINO to SOL y Entity Framework. 


Todos estos proveedores, excepto Entity Framework, se lanzaron con .NET 
Framework 3.5 y a partir de .NET 4.0, Entity Framework (LINO to Entities) será 
el proveedor LINQ recomendado por Microsoft para acceso a bases de datos rela- 
cionales. ¿Por qué? Porque permite a una aplicación conectarse a fuentes de datos 
de diferentes proveedores (LINO to SOL está prácticamente destinado a trabajar 
con SQL Server), permite modelar distintos tipos de herencia (por jerarquía, por 
subtipo o herencia por tipo concreto), soporta asociaciones de “muchos a muchos” 
(LINO to SOL solo permite la correlación o mapeo “uno a uno”), su nivel de abs- 
tracción es elevado y su capa de Servicios de objetos es mucho más amplia y está 
orientada a no ser simplemente un ORM (Object-Relational Mapping), sino todo 
un lenguaje conceptual a la hora de desarrollar aplicaciones conectadas a datos y 
porque la lógica se puede extender y escalar más fácilmente. 


Aplicación 
Lenguaje CH 
Lenguaje de consultas integrado (LINQ) 


Tecnologías LINQ para ADO.NET 


LINQ LINQ LINQ LINQ 
to Objects to DataSet to SQL to Entities 
jase de dato: 
relacional 


Actualmente ya hay varios proveedores de Entity Framework desarrollados, 
tanto por la comunidad de software libre como por empresas particulares, entre 
los cuales destacamos los siguientes: devart dotConnect for Oracle, SOLLite, 
PostgreSQL y MySQL, DataDirect Oracle Provider, MySQL Connector, etc. 
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MARCO DE ENTIDADES DE ADO.NET 


El marco de entidades de ADO.NET (Entity Framework o EF) es un entorno de 
desarrollo de la plataforma .NET que permite superponer varias capas de abstrac- 
ción sobre las bases de datos relacionales (véase la figura que presentamos un po- 
co más adelante) con el fin de hacer posible una programación más conceptual 
(basada en los conceptos del dominio en el que se trabaja) y reducir al mínimo el 
desajuste de impedancias causado por las diferencias entre los modelos orientados 
a objetos y los modelos relacionales. 


Para minimizar ese desajuste de impedancias se ha recurrido a un patrón de 
diseño muy común para el modelado de datos y que consiste en dividir este mode- 
lado en tres partes: 


e Un modelo conceptual para definir las entidades y relaciones del sistema que 
se está modelando. 

e Un modelo lógico para describir la base de datos relacional: tablas, relaciones 
entre las tablas con restricciones de claves externas, etc. 

e Un modelo físico para definir detalles específicos (almacenamiento, índices, 
etc.) en función del motor de bases de datos utilizado. 


De todos es conocido que muchos desarrolladores omiten la creación del mo- 
delo conceptual y comienzan especificando las tablas, columnas y claves en una 
base de datos relacional. Pues bien, EF' nace con la idea de rescatar el modelo 
conceptual permitiendo a los programadores consultar las entidades y relaciones 
que lo forman y traduciendo esas consultas en órdenes específicas del origen de 
datos. Para ello es necesario que exista una correlación entre estos dos mundos di- 
ferentes: modelo conceptual y modelo lógico. Pues bien, lo que hace EF es expre- 
sar esta correlación en una especificación externa denominada Modelo de 
entidades (EDM: Entity Data Model). 


El modelo de entidades aporta múltiples características para eliminar el desa- 
juste de impedancias con el que se encuentran los programadores orientados a ob- 
jetos con respecto a los modelos relacionales implementados por los profesionales 
de bases de datos. Está construido sobre las tres secciones siguientes, definidas, 
como veremos más adelante, en un fichero .edmx: 


e SSDL (Storage Schema Definition Languaje). Define el espacio S (Storage). 
Describe, en formato XML, el modelo relacional de la base de datos subya- 
cente. 


e CSDL (Conceptual Schema Definition Languaje). Define el espacio C (Con- 
ceptual). Describe, en formato XML, las entidades que deseamos tener en 
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nuestro modelo conceptual, así como las propiedades de navegación o asocia- 
ciones entre las distintas entidades. 

e MSL (Mapping Schema Languaje). Describe, en formato XML, cómo se aso- 
cian o relacionan las entidades del modelo conceptual (CSDL) con las tablas, 


relaciones, columnas y demás elementos del modelo relacional. 


Y, ¿cómo realiza EF las consultas sobre el modelo conceptual? Pues utilizan- 
do algunos de los mecanismos siguientes: 


Marco de entidades de ADO.NET 


LINQ to Entities 


ObjectQuery 
Entity SQL Entity SQL 
Entity Client 


Modelo conceptual (CSDL) 
Asignación (MSL) 
Modelo lógico (SSDL) 


ase de dato 
relacional 


e LINO to Entities. Es el proveedor de LINQ diseñado para consultar las enti- 
dades que definen el modelo conceptual. Como alternativas a LINQ, tenemos 
la posibilidad de utilizar procedimientos almacenados, o bien expresar direc- 
tamente las consultas en eSOL. 
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e Entity SOL (eSOL). Es el lenguaje de consulta de modelos conceptuales; se 
deriva de SQL. Es precisamente el lenguaje de entrada para el proveedor de 
entidades (Entity Client). Se trata de un lenguaje de consulta de modelos de 
entidades, independiente de cualquier base de datos específica, que Entity 
Client se encarga de traducir en sentencias aceptables para la base de datos 
especifica sobre la que se ha construido el modelo conceptual. 


e Métodos del generador de consultas. La clase ObjectQuery proporciona un 
conjunto de métodos que se pueden utilizar para construir consultas equiva- 
lentes a las obtenidas con Entity SOL. 


Entity Client es el proveedor de entidades de ADO.NET. Este proveedor, a di- 
ferencia de los proveedores de datos de ADO.NET que trabajan sobre el modelo 
físico de la base de datos, trabajará sobre el modelo de entidades. Su misión es 
administrar las conexiones, traducir las consultas de entidad en consultas específi- 
cas del origen de datos y devolver un lector de datos que los Servicios de objetos 
materializarán en objetos si esta operación es requerida; en otro caso, se puede 
usar el lector de datos devuelto. 


Los servicios de objetos permiten definir cada uno de los objetos de entidad 
así como el contexto de objetos a los que se refiere el modelo de objetos. Este 
modelo define el espacio O (Object). 


El diagrama siguiente muestra cómo se accede a los datos. En dicho diagra- 
ma, a la izquierda, distinguimos un primer nivel de abstracción, denominado Enti- 
ty Data Model (EDM), que se corresponde con un modelo entidad-relación o 
modelo conceptual que ofrece una capa de asignación C-S (Conceptual-Storage) 
que nos permite operar sobre el modelo lógico desde las entidades del modelo 
conceptual, y un segundo nivel de abstracción que se corresponde con un modelo 
de objetos que ofrece una capa de asignación O-C (Object-Conceptual) que nos 
permite operar sobre el modelo lógico, pasando por el modelo conceptual. 


A la derecha de la figura se esquematizan las herramientas Entity Data Model 
(bibliotecas de clases) de las que disponemos para realizar esas operaciones que 
resumimos a continuación. 


Una flecha hacia abajo indica una consulta sobre el origen de datos y una ha- 
cia arriba indica los datos devueltos. Los servicios de objetos generan un árbol de 
órdenes canónico que representa la consulta LINQ o una operación de Entity SOL 
con el modelo conceptual. Después, el proveedor de entidades transforma este ár- 
bol, basado en el modelo EDM, en un nuevo árbol que es una operación equiva- 
lente en el origen de datos (SELECT, UPDATE, INSERT y DELETE). 
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LINQ to 
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ObjectQuery 


Árbol de 
órdenes 












Modelo de objetos 


Asignación 


O-C 
Modelo conceptual 


Asignación 


-S 
Modelo lógico 











EntityDa- 
taReader 














Proveedor de entidades 










Árbol de 
órdenes 





DBData- 
Reader 












ase de dato: 
relacional 


Consultar un modelo de objetos 


El modelo de objetos permite consultar, insertar, actualizar y eliminar datos, ex- 
presados como objetos de los tipos de entidad que se definen en el EDM. Las con- 
sultas son realizadas a través de los servicios de objetos y pueden ser consultas 
LINQ o consultas Entity SOL encapsuladas en un objeto de la clase Object- 
Query. Así mismo, los servicios de objetos propagarán los cambios realizados 
sobre los objetos hacia el origen de datos y materializarán los datos devueltos en 
objetos. También proporcionan medios para realizar el seguimiento de los cam- 
bios, enlazar los objetos a los controles y controlar la simultaneidad. Estos servi- 
cios están definidos por las clases de los espacios de nombres System.Data.Ob- 
jects y System.Data.Objects.DataClasses y las clases que dan lugar a los objetos 
de este modelo se derivan de estas, como, por ejemplo, de ObjectContext o Enti- 
tyObject. 


Por ejemplo, supongamos que hemos construido un EDM cuyo modelo de ob- 
jetos está definido por el contexto de objetos bd_notasAlumnosEntities, derivado 
de ObjectContext, y por las entidades correspondientes, como alumno, derivadas 
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de EntityObject (en el próximo apartado veremos cómo se construye un EDM a 
partir de una base de datos). Partiendo de este supuesto, el siguiente ejemplo indi- 
ca cómo sería una consulta LINQ frente a la misma consulta Entity SOL: 


bd_notasAlumnosEntities contextoDe0bjs = 
new bd_notasAlumnosEntities(); 


// Consulta LINQ 

var consulta = 
from alum in contextoDe0bjs.alumnos 
select alum.nombre; 


foreach (var nomAlum in consulta) 
Console.WritelLine(nomAlum); 


H Consulta Enricy SOL 
string sConsulta = "SELECT VALUE alum.nombre " + 
"FROM bd_notasAlumnosEntities.alumnos AS alum"; 
ObjectQuery<string> consulta = 
new ObjectQuery<string>(sConsulta, contextoDe0bjs); 





foreach (var nomAlum in consulta) 
Console.WriteLine(nomAlum); 





La cláusula FROM se puede utilizar para especificar uno o varios orígenes, 
separados por comas, para una instrucción SELECT. La forma más sencilla es la 
del ejemplo anterior: una expresión de una única consulta que identifica una co- 
lección y un alias que se usa como origen en una instrucción SELECT. La cláu- 
sula SELECT se evalúa después de la cláusula FROM. 


El objeto consulta de tipo ObjectQuery<string> implementa la interfaz 
IQueryable<T>, por lo que puede ser accedido a través de una sentencia foreach. 


ObjectQuery también implementa un conjunto de métodos del generador de 
consultas que se pueden utilizar para construir la consulta equivalente a la expre- 
sada mediante eSQL. El resultado es una expresión más cercana a LINQ y, por lo 
tanto, evita tener que conocer el lenguaje eSOL. Algunos de estos métodos son: 
Select, Where, GroupBy u OrderBy. Por ejemplo: 


// Métodos del generador de consultas 
ObjectQuery<alumno> consulta = 

new ObjectQuery<alumno>("alumnos", contextoDe0bjs); 
consulta = consulta.Where("it.1d_alumno=1234567"); 


foreach (var alum in consulta) 
Console.Writeline(alum.nombre):; 


CAPÍTULO 14: LINQ 661 


Observe la utilización de it (“eso”) en el predicado. Es una palabra reservada 
predefinida para hacer referencia al nombre de la entidad que se consulta. 


El modelo conceptual contiene entidades (por ejemplo, alumno) y asociacio- 
nes (por ejemplo, la relación alumno-alums_asigs). Las consultas sobre este mo- 
delo son realizadas por medio del proveedor de entidades Entity Client, que 
proporciona clases como EntityConnection, EntityCommand o EntityData- 
Reader del espacio de nombres System.Data.EntityClient, utilizando el lenguaje 
Entity SOL. Por ejemplo: 


// Consulta con Entity Client 
string sConexion = ConfigurationManager. 
ConnectionStrings["bd_notasAlumnosEntities"].ConnectionString; 
var conexion = new EntityConnectioní(sConexion); 
string sConsulta = "SELECT VALUE alum.nombre " + 
"FROM bd_notasAlumnosEntities.alumnos AS alum”; 
var consulta = new EntityCommand(sConsulta, conexion); 
conexion.Open(); 
EntityDataReader lector = 
consulta.ExecuteReader(CommandBehavior.SequentialAccess); 
while(Tector.Read()) 
Console.WriteLine(lector[0]); 
conexion.Close(); 














El modelo lógico contiene tablas, vistas, procedimientos almacenados y fun- 
ciones definidas por el usuario. Las consultas son realizadas utilizando las clases 
tradicionales de ADO.NET que vimos en el capítulo Acceso a una base de datos 
(por ejemplo, SqlConnection, SqlCommand o SqlDataReader). Por ejemplo: 


// Consulta con SqlClient 
string sConexion = 
"Data Source=.11sqlexpress;Initial Catalog=bd_notasAlumnos;" + 
"Integrated Security=True"; 
var conexion = new SqlConnection(sConexion); 
string sConsulta = "SELECT alumnos.nombre FROM alumnos"; 
var consulta = new SqlCommand(sConsulta, conexion); 
conexion.Open(); 
SqlDataReader lector = consulta.ExecuteReader(); 
while (lector.Read()) 
Console.Writeline(lector[01); 
conexion.Closeí); 








Finalmente, hay que mencionar algunos de los patrones de diseño, como Data 
Mapper, Value Object (también denominado Data Transfer Object) y Lazy 
Loading, muy unidos a EF. El patrón de diseño Data Mapper tiene como fin sepa- 
rar un modelo de objetos de un modelo relacional y realizar la transferencia de da- 
tos entre ambos. Value Object es un objeto que permite transportar de una vez una 
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colección de datos entre dos capas diferentes de una aplicación. Y el patrón de di- 
seño Lazy Loading permite retardar la carga de un objeto resolviendo problemas 
de carga desmesurada y dependencias circulares; por ejemplo, piense en una rela- 
ción uno a muchos, donde un objeto de negocio Object01 posee una colección de 
otros objetos Object02; cuando el objeto Object01 es solicitado, se trae a memoria 
solo este objeto, con la colección de objetos vacía y los objetos Object02 serán 
cargados posteriormente, cuando realmente se necesiten. 


Ahora bien, a partir de la versión 4.1 de Entity Framework (con VS 2012 ya 
estaba disponible la versión 5.0 y se estaba trabajando sobre la 6.0) el modelo de 
objetos queda definido por un contexto de objetos derivado de DbContext del es- 
pacio de nombres System.Data.Entity. La clase DbContext es conceptualmente 
similar a ObjectContext. 


La clase ObjectContext es parte de EF y es la clase que permite realizar con- 
sultas, seguimiento de cambios y actualizar la base de datos usando las clases que 
representan el modelo. La clase DbContext se describe mejor como un envoltorio 
de ObjectContext que expone las características de ObjectContext más común- 
mente utilizadas y proporciona algunos “atajos” más sencillos para las tareas que 
son frecuentemente utilizadas pero complicadas de codificar con ObjectContext. 
También, las clases DbSet y DbQuery presentan mejoras con respecto a sus ho- 
mólogas ObjectSet y ObjectQuery. 


La clase DbContext se utiliza generalmente derivando una clase que conten- 
ga propiedades DbSet<TEntity> para hacer referencia a las colecciones de entida- 
des del modelo. Estas colecciones se inician automáticamente cuando se crea un 
objeto de la clase derivada. Por ejemplo: 


public partial class bd_notasAlumnmosEntities : DbContext 
( 
public bd_notasAlumnosEntities() 
base("name=bd_notasAlumnosEntities") 
( 
) 


public DbSet<alumno> alumnos { get; set; } 
public DbSet<alum_asig>» alums_asigs { get; set; ) 
public DbSet<asignatura» asignaturas { get; set; } 


La clase DbContext aporta fundamentalmente dos cosas: facilidad y un nue- 
vo enfoque (Code First) de construir el modelo de entidades, que estudiaremos un 
poco más adelante en este mismo capítulo. Sin embargo, si fuera necesario obte- 
ner una referencia al objeto ObjectContext que subyace bajo DbContext bastaría 
con añadir el siguiente método a la clase que define el contexto: 
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public partial class bd_notasAlumnosEntities : DbContext 
( 
E 
public ObjectContext ObtenerO0bjectContext() 
( 
return (this as IObjectContextAdapter).ObjectContext; 
) 


La clase DbSet<TEntity> representa un conjunto de entidades de un tipo es- 
pecífico que se utiliza para ejecutar operaciones de creación, lectura, actualización 
y eliminación. Un objeto DbSet solo puede ser construido a partir de un objeto 
DbContext. 


Según esto, el ejemplo anterior, en el caso de la consulta LINO, no sufriría 
modificaciones, y en el caso de la consulta Entity SOL habría que hacer una pe- 
queña modificación, ya que ObjectQuery requiere como segundo argumento un 
objeto ObjectContext que obtendríamos a través del método ObtenerObjectCon- 
text, según se ve a continuación: 


bd_notasAlumnosEntities contextoDe0bjs = 
new bd_notasAlumnosEntities(); 


// Consulta LINO 

var consulta = 
from alum in contextoDe0bjs.alumnos 
select alum.nombre; 


foreach (var nomAlum in consulta) 
Console.WriteLine(nomAlum); 


// Consulta Entity SQL 

string sConsulta = "SELECT VALUE alum.nombre " + 
"FROM bd_notasAlumnosEntities.alumnos AS alum”; 

ObjectQuery<string>» consulta = 


new ObjectQuery<string>(sConsulta, contextoDe0bjs.ObtenerObjectContext()); 


foreach (var nomAlum in consulta) 
Console.WriteLine(nomAlum); 





ACCESO A UNA BASE DE DATOS 


Vamos a realizar una aplicación que trabaje con los datos de una base de datos 
SQL Server. Para empezar, elegiremos la base de datos bd_notasAlumnos que uti- 
lizamos en el capítulo Acceso a una base de datos, apartado Ejercicios propuestos 
(notas de los alumnos matriculados en un determinado centro de unas determina- 
das asignaturas). 
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Empecemos por crear una aplicación con Visual Studio denominada ApEnti- 
dades. Para ello, abra Visual Studio y cree un nuevo proyecto de tipo Visual CH > 
Windows > Aplicación de Windows Forms. 


Conectarse a la base de datos 


Abra el Explorador de servidores (Explorador de bases de datos) y añada una co- 
nexión a la base de datos bd_notasAlumnos (este proceso ya fue explicado en el 
capitulo Acceso a una base de datos). 


Generar el modelo de entidades 


El modelo de objetos que ofrece una capa de asignación O-C (Object-Concep- 
tual), expresado en el lenguaje de programación con el que se esté escribiendo la 
aplicación (en nuestro caso C+f), nos va a proporcionar un nivel de abstracción 
que, pasando por el modelo conceptual, nos permitirá operar sobre el modelo ló- 
gico. Gracias al modelo de objetos, que para nosotros representa una base de datos 
orientada a objetos virtual imagen del modelo relacional, podemos abstraernos no 
solo del modelo lógico, sino del lenguaje SQL correspondiente al motor de base 
de datos que estemos utilizando. Para generar automáticamente este modelo a par- 
tir de una base de datos existente, diseño conocido como la Base de datos Prime- 
ro (Database First), hay tres herramientas que se usan conjuntamente y sirven de 
ayuda para generar, modificar y actualizar un EDM: 


e Asistente para el EDM (Entity Data Model). Permite generar un EDM a partir 
de una base de datos existente, agregar a la aplicación información de cone- 
xión a la base de datos y generar las clases (que denominaremos “clases de 
entidad”) en el lenguaje de programación utilizado basadas en el modelo con- 
ceptual. Cuando este asistente termina de generar un EDM, inicia el diseñador 
de entidades. 
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e Diseñador de entidades (Entity Designer). Este diseñador proporciona una su- 
perficie de diseño que permite crear y modificar visualmente entidades, aso- 
ciaciones, asignaciones y relaciones de herencia, así como validar o actualizar 
un EDM. 


También, a partir de VS 2010, se pueden añadir propiedades de navegación o 
complejas, o usar plantillas 74 (Text Template Transformation Toolkit) para 
personalizar la generación de código. EF utiliza T4 no solo para la generación 
de código, sino para realizar un diseño el Modelo Primero (Model First); esto 
es, definir primero nuestro modelo conceptual para luego lanzar desde el me- 
nú contextual del diseñador un asistente que genere el modelo lógico. 


e Asistente para actualizar el modelo desde la base de datos. Este asistente per- 
mite actualizar un EDM cuando se realizan cambios en la base de datos sub- 
yacente. Este asistente se inicia desde el menú contextual de Entity Designer. 


El asistente para el EDM se inicia a partir de la plantilla ADO. NET Entity Da- 
ta Model de Visual Studio y almacena el EDM generado en un fichero con exten- 
sión .edmx. Después, el generador de código de EF creará a partir del contenido 
CSDL (almacenado en el fichero .edmx) el código correspondiente a las clases del 
modelo de objetos representativo de la base de datos virtual con la que vamos a 
trabajar. También, generará una clase derivada de DbContext que facilita las ope- 
raciones de consultar y trabajar con las entidades como objetos. Todo esto consti- 
tuye lo que hemos denominado en el capítulo Acceso a una base de datos “capa 
de acceso a datos” (DAL). 





Base de datos 


Según lo estudiado hasta ahora, un enfoque adecuado en el desarrollo de apli- 
caciones es separar la capa de acceso a datos (DAL) de la capa de presentación, 
según estudiamos en el capítulo Acceso a una base de datos. La DAL típicamente 
se implementa como un proyecto Biblioteca de clases, según estudiamos en el ca- 
pítulo Enlace de datos en Windows Forms. Entonces, como siguiente paso, añada 
un nuevo proyecto Biblioteca de clases a la solución ApEntidades, por ejemplo 
BDNotasAlumnos, y a continuación agregue a este proyecto un EDM denominado 
MDEBDNotasAlums. 
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Según lo expuesto anteriormente, para abrir el asistente para el EDM agregue 
un nuevo elemento de tipo ADO.NET Entity Data Model al proyecto BDNotas- 
Alumnos. En nuestro caso, denominaremos al EDM que se generará MDEBDNOo- 
tasAlums.edmx. 
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Después de hacer clic en el botón Agregar, seremos preguntados por el conte- 
nido del modelo y si lo generamos desde una base de datos: 








r z 3 
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ATO] Elegir contenido del modelo 


¿Qué debería contener el modelo? 
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Seleccionamos la opción Generar desde la base de datos y hacemos clic en 
Siguiente, elegimos la conexión de datos que debe utilizar la aplicación para co- 
nectarse a la base de datos, aceptamos guardar la configuración de conexión de la 
entidad en el fichero de configuración App. Config con el nombre especificado (es- 
ta cadena de conexión tiene una sintaxis diferente a la cadena de conexión utiliza- 
da para conectarnos desde ADO.NET a una base de datos del servidor SQL 
Server) y, en el paso siguiente, elegimos los elementos de la base de datos que de- 
berá contener el modelo, en nuestro caso las tablas alumnos, alums_asigs y asig- 
naturas: 
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y 
Asistente para Entity Data Model 0 esa) 


B: 





Elegir los objetos y la configuración de la base de datos 


¿Qué objetos de la base de datos desea incluir en su modelo? 
zo 
VS dbo 

MER alumnos 
(MER alums_asigs 
[MIER asignaturas 

Elg Vistas 

Eg Funciones y procedimientos almacenados 











E Poner en plural o en singular los nombres de objeto generados 





[Y] Incluir columnas de clave externa en el modelo 


Espacio de nombres del modelo: 


ModeloBDNotasAlumnos 














< Anterior Cancelar 


K d 








Observe que podriamos haber elegido la opción Poner en plural o en singular 
los nombres de objeto generados. Para entender lo que esta opción aporta, por ser 
la primera vez, haremos esta operación manualmente un poco más adelante. 


A continuación, especificamos el espacio de nombres del modelo, Mode- 
loBDNotasAlumnos, y hacemos clic en Finalizar. La ventana de diseño de Visual 
Studio mostrará el diseñador de entidades que muestra la figura siguiente: 
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Si ahora hace clic con el botón secundario del ratón sobre el diseñador de en- 
tidades y observa el menú contextual, podrá ver todas las operaciones que se pue- 
den realizar sobre el EDM y que anteriormente ya citamos. 


Al crear el modelo de entidades (fichero MDEBDNotasAlums.edmx) y gene- 
rar las entidades (fichero MDEBDNotasAlums. Designer.cs), se crearon automáti- 
camente las asociaciones entre ellas basándose en las relaciones de clave externa 
existentes en la base de datos. No obstante, también puede realizar esta asociación 
haciendo clic sobre la clase de entidad y seleccionando del menú contextual la op- 
ción Agregar asociación. 


Entity Data Model utiliza tres conceptos clave para describir la estructura de 
datos: tipo de entidad, tipo de asociación y propiedad. El tipo de entidad es la 
unidad fundamental para describir la estructura de datos en un modelo conceptual 
y se construye a partir de las propiedades; las entidades describen la estructura de 
conceptos de nivel superior, como alumnos y asignaturas; las propiedades defi- 
nen sus características; así, por ejemplo, el tipo de entidad alumnos contiene pro- 
piedades como id alumno o nombre. Una instancia de un tipo de entidad 
representa un objeto específico (como un alumno o una asignatura). Cada entidad 
debe tener una clave de entidad única dentro de un conjunto de entidades: colec- 
ción de instancias de un tipo de entidad concreto. Según lo expuesto, la relación 
entre un tipo de entidad y un conjunto de entidades es análoga a la relación entre 
una fila y una tabla en una base de datos relacional: al igual que una fila, un tipo 
de entidad describe la estructura de los datos, y, al igual que una tabla, un conjun- 
to de entidades contiene instancias de un determinado tipo de entidad. Según esto, 
parece más lógico nombrar las entidades en singular y los conjuntos de entidades 
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en plural, en vez de como las ha nombrado el asistente que generó el EDM (esto 
se hubiera hecho automáticamente si en el asistente para Entity Data Model hu- 
biéramos elegido la opción Poner en plural o en singular los nombres de objeto 
generados). 


El diagrama anterior muestra un modelo conceptual con tres tipos de entidad: 
alumnos, alums_asigs y asignaturas. Para hacer que se llamen alumno, alum_asig 
y asignatura, seleccione cada una de ellas y modifique el nombre, bien desde la 
ventana de propiedades (propiedad Nombre), o bien desde el propio diseñador, 
según muestra la figura siguiente: 


El Propiedades 
Y? id_alumno 
# nombre 





E Propiedades de navegación 


$l alums_asigs 





Para la descripción de las relaciones entre tipos de entidades, la unidad fun- 
damental es el tipo de asociación o simplemente asociación. En un modelo con- 
ceptual, una asociación representa una relación entre dos tipos de entidad (como 
alumno y alum_asig) especificados por sus dos extremos, cada uno de los cuales 
especifica también una multiplicidad que indica el número de entidades que pue- 
den estar en ese extremo de la asociación: una (1), cero o una (0..1) o muchas (*). 
De aquí las propiedades de navegación, como alums_asigs, utilizadas para acce- 
der a las entidades situadas en un extremo de una asociación. Según esto, si en un 
extremo el número de identidades es una, parece más lógico que la propiedad de 
navegación correspondiente se nombre en singular (una entidad) y en plural, 
cuando sean muchas (una colección de entidades). Modificamos entonces en este 
sentido las propiedades de navegación de la entidad alum_asig. 


Después de todas las modificaciones, el diagrama de entidades queda así: 


= Propiedades 


= Propiedades 42 id_alumno = Propiedades 


4% id_asignatura 
# nota 


4% id_asignatura 
# nombre 


Y? id_alumno 
# nombre 





E Propiedades de navegación 


= Propiedades de navegación = Propiedades de navegación 


4 alumno 


y alums_asigs $l alums_asigs 


$l asignatura 
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De forma predeterminada, EF crea la lógica para actualizar una base de datos 
(inserciones, actualizaciones y eliminaciones) con los cambios realizados en los 
datos de las clases de entidad, basándose en el esquema de la tabla (información 
de columna y de clave principal). Cuando no se desea usar el comportamiento 
predeterminado, se puede configurar el comportamiento asignando procedimien- 
tos almacenados concretos a través del diseñador. 


Así mismo, desde el menú contextual del diseñador de entidades podemos 
mostrar también el Explorador de modelos que muestra la figura siguiente, desde 
el que podemos observar el modelo conceptual y el modelo lógico o de almace- 
namiento: 
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v 


También, ejecutando la orden Ver > Otras ventanas > Detalles de la asigna- 
ción de Entity Data Model podrá comprobar los detalles de la asignación C-S para 
la entidad que seleccione. Si, a continuación, hace clic en otra entidad, la vista de 
detalles cambiará para mostrar los de esta otra entidad: 
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ET E E Forml.cs Form1.cs [Diseño] X 





E Propiedades 


E Propiedades $ id_alumno E Propiedades 
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Y <Agregar condición> 
4 El Asignaciones de columnas 


4 id_alumno : int e 2 id_alumno : Int32 

% id_asignatura : int = 2 id_asignatura : Int32 

B nota: real e # nota : Single - 
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Una vez finalizadas las tareas descritas, ya tenemos generado el modelo de 
objetos y el contexto de objetos (DbContext), que en nuestro caso está represen- 
tado por la clase bd _notasAlumnosEntities. Se trata de una clase derivada de 
DbContext que representa el contenedor de entidades (agrupación lógica de los 
conjuntos de entidades (DbSet<TEntidad>)) definido en el modelo conceptual. 
Dicha clase tiene el aspecto siguiente: 


using System.Data.Entity; 
using System.Data.Entity.Infrastructure; 


public partial class bd_notasAlumnmosEntities : DbContext 
( 
public bd_notasAlumnosEntities() 
base("name=bd_notasAlumnosEntities") 
( 
) 


public DbSet<alumno> alumnos { get; set; } 
public DbSet<alum_asig>» alums_asigs { get; set; ) 
public DbSet<asignatura>» asignaturas { get; set; } 


No obstante, siempre podríamos volver a la generación de código en base a la 
clase ObjectContext si fuera necesario. Bastaría con eliminar los dos ficheros 
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con extensión .tt (plantillas escritas en T4) que aparecen seleccionados en la figu- 
ra siguiente, que son los que dan lugar a la generación de la clase derivada de 
DbContext y las clases de entidad y a continuación, abriríamos el diseñador de 
EF (el fichero .edmx) y en la ventana de propiedades simplemente cambiaríamos 
el valor Ninguno de su propiedad Estrategia de generación por Predeterminado. 


4 ¿$ MDEBDNotasAlums.edmx 


b = MDEBDNotasAlums.Context.tt 


>  *) MDEBDNotasAlums.Designer.cs 
1 MDEBDNotasAlums.edmx.diagram 


» Ð MDEBDNotasAlums.tt 


Para poder utilizar el modelo de entidades que acabamos de generar en el 
proyecto ApEntidades, habrá que añadir al mismo una referencia (nodo Referen- 
ces) a la biblioteca BDNotasAlumnos. Otras cosas que también tenemos que hacer 
son añadir una referencia a System.Data.Entity y copiar en el fichero App. Config 
del proyecto ApEntidades el contenido del fichero de configuración App.Config 
del proyecto BDNotasAlumnos, ya que este fichero contiene la cadena de cone- 
xión para acceder a la base de datos; tenga presente que el elemento <configSec- 
tions> debe ser el primer elemento secundario del elemento raíz <configuration>. 


Finalmente, si disponemos de NuGet (una extensión de Visual Studio para 
agregar/quitar bibliotecas que VS 2012 ya incluye; en otro caso, habría que insta- 
lar este paquete; para más detalles, véase el apartado Code First: un nuevo modelo 
de trabajo más adelante en este mismo capítulo) solamente tenemos que instalar 
en el proyecto un paquete llamado Entity Framework e incluir una referencia al 
mismo, bien desde la consola de órdenes de NuGet (menú Herramientas > Admi- 
nistrador de paquetes de biblioteca > Consola del Administrador de paquetes): 


Consola del Administrador de paquetes Y AX 


Origen del paquete: Origen del paquete oficial de ! ~ o 


PM> Install-Package EntityFramework a 
'EntityFramework 5.0.0' ya está instalado. 
'EntityFramework 5.0.0' se agregó correctamente a ApEntidades. 


Type *get-help EntityFramework' to see all available Entity Framework commands . 


PM> - 
100% + 
Consola del... Operaciones... Lista de erro... Jerarquía de... Resultados Resultados d... Resultados d... 


o bien desde el menú contextual del proyecto (opción Administrar paquetes Nu- 
Get). Esto es así porque EF ya se distribuye separadamente de .NET Framework, 
permitiendo así que el equipo de EF pueda liberar versiones sin esperar a la pró- 
xima versión oficial de NET Framework. 
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m 
ApEntidades: administrar paquetes NuGet A=) 
b Paquetes instalados Solo estable ~ Ordenar por: Más descargados + Buscar en la En línea (( ® ~ | 
A ír R 
Salie a jQuery Â Creado por: Microsoft 
jQuery is a new kind of JavaScript Library. 


i ji i z Er Fram 
Origen del paquete oficial de NuGet jQuery is a fast and concise JavaScript Li... o eniami 


Versión: 5.0.0 
b Actualizaciones EntityFramework Última publicación: 8/11/2012 1] 
Entity Framework is - Descargas: 1577023 
Microsoft's recommende... Ver términos de licencia 





Información del proyecto 
B Json.NET Notificar abuso 

Json.NET is a popular high-performance Descripción: 
JSON framework for .NET 


Entity Framework is Microsoft's 





. ¡Query Validation recommended data access technology for 

Cada uno de los paquetes se le This ¡Query plugin makes simple clientside new applications. 
otorga bajo licencia de su propietario form validation trivial, while offering lots... Dependencias: 
respectivo. Microsoft no es A No hay di dena 
responsable ni otorga ninguna LAMA Miesa Wan fastig any CEPENOEINIAS, 
licencia en relación con paquetes de ai pie package AS the Ei ~ i 
terceros. WEP D | 

E o] 
| Configuración Cerrar | 

















K == y 





Para verificar que el trabajo realizado hasta ahora es correcto, desde el evento 
Load de Form] puede ejecutar en modo depuración (F5) el siguiente código y 
observar el resultado en el panel de Resultados. Una vez realizada la prueba, 
vuelva al estado anterior. 


private void Forml_Load(object sender, EventArgs e) 
( 
bd_notasAlumnosEntities contextoDe0bjs = 
new bd_notasAlumnosEntities(); 


// Consulta LINQ 

var consulta = 
from alum in contextoDe0bjs.alumnos 
select alum.nombre; 


foreach (var nomAlum in consulta) 
Console.WriteLine(nomA1um); 


Las clases de entidad y el contexto de objetos 


En el explorador de modelos (véase la figura un par de páginas atrás) observamos 
que se ha generado una clase de entidad por cada entidad del modelo conceptual 
(un objeto de una de estas entidades se corresponderá con una fila de la tabla aso- 
ciada de la base de datos) y otra clase bd notasAlumnosEntities derivada de 
DbContext. Las clases de entidad constituyen el modelo de objetos, y la otra, el 
contexto de objetos que provee la funcionalidad para consultar y trabajar con las 
entidades como objetos. 
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A su vez, cada clase de entidad define u 


na propiedad por cada columna de la 


tabla asociada, con el mismo nombre, así como otras propiedades, denominadas 
“propiedades de navegación”, para definir las relaciones que existen entre las ta- 
blas (estas devuelven un ICollection<7Entidad> para las relaciones 1..* o una re- 


ferencia TEntidad para las relaciones *..1). 
estas clases de entidad (la clase que define e 
anteriormente: 
public partial class alumno 
( 
public alumno() 
( 


this.alums_as1igs new HashSet<al 
) 
// Propiedades correspondientes a la 
public int id_alumno { get; set; ) 
public string nombre { get; set; ) 
// Propiedades de navegación 


public virtual ICollection<alum_asi 











Veamos el código que implementan 
l contexto de objetos ya fue expuesta 


um_asig»(); 


s columnas de la tabla asociada 


g> alums_asigs { get; set; ) 


public partial class alum_asig 
( 
// Propiedades correspondientes a las columnas de la tabla asociada 
public int id_alumno { get; set; } 
public int id_asignatura { get; set; } 
public float nota { get; set; ) 
// Propiedades de navegación 
public virtual alumno alumno { get; set; ) 
public virtual asignatura asignatura { get; set; ) 














public partial class asignatura 

( 
public asignatura() 
( 

this.alums_asigs = new HashSet<a! 

) 
// Propiedades correspondientes a la 
public int id_asignatura { get; set; 
public string nombre [ get; set; } 
// Propiedades de navegación 
public virtual ICollection<alum_asi 





} 


um_asig»(); 


s columnas de la tabla asociada 
) 


g> alums_asigs { get; set; ) 


Obsérvese que las clases de entidad son públicas (public) y que las propieda- 


des de navegación son virtuales (virtual). 
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La clase bd_notasAlumnosEntities derivada de DbContext contiene la infor- 
mación de la cadena de conexión, la cual es proporcionada a través de su cons- 
tructor, varias propiedades, por ejemplo, alumnos, y varios métodos (por ejemplo, 
el método SaveChanges que envía los datos actualizados del modelo de objetos 
de EF a la base de datos) a los que se puede llamar para realizar las operaciones 
deseadas sobre la base de datos. Fíjese también en las propiedades alumnos, asig- 
naturas o alums_asigs de esta clase, retornan un objeto de tipo DbSet<TEntidad> 
que representa un conjunto de entidades de tipo TEntidad (o dicho de otra forma, 
una secuencia de objetos “filas de la tabla”) utilizado para realizar operaciones de 
creación, lectura, actualización y eliminación (DbSet se deriva de DbQuery que 
representa una consulta LINO to Entities contra un DbContext). Como la colec- 
ción de objetos implementa la interfaz IQueryable que hereda de IEnumerable, 
podremos aplicar LINQ sin problemas. Por ejemplo, la propiedad alumnos de- 
vuelve un objeto DbSet<alumno> que se corresponde con una secuencia de obje- 
tos de la clase de entidad alumno, cada uno de los cuales se corresponde con una 
fila de la tabla alumnos. 


Según lo expuesto, para que una aplicación dotada de un contexto de objetos, 
como lo es bd notasAlumnosEntities, pueda acceder a la base de datos correspon- 
diente, deberá crear un objeto DbContext. Por ejemplo: 


// Obtener el contexto de objetos 
bd_notasAlumnosEntities contextoDe0bjs = 
new bd_notasAlumnosEntities(); 
// Obtener la tabla alumnos 
DbSet<alumno> TablaAlumnos = contextoDe0bjs.alumnos; 
// Realizar una consulta 
var alums = from alum in TablaAlumnos 
where alum.id_alumno == 1234567 
select new { Nombre = alum.nombre }; 
if (alums.Count() > 0) 
Console.Writeline(alums.First().Nombre); 




















¿Cuánto tiempo permanece abierta la conexión con la base de datos? Nor- 
malmente, una conexión permanece abierta mientras se utilizan los resultados de 
la consulta. Por ejemplo: 


var alums = from alum in contextoDe0bjs.alumnos 
select alum; 
Console.WriteLine(contextoDe0bjs.Database.Connection.State); 
// escribe: Closed 
foreach (var alum in alums) 
{ 
1! 
Console.WriteLine(contextoDe0bjs.Database.Connection.State); 
// escribe: Open 
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Console.WriteLine(contextoDe0bjs.Database.Connection.State); 
// escribe: Closed 


Ahora bien, si espera que los resultados van a tardar bastante tiempo en pro- 
cesarse, y no le causa ningún problema que se almacenen en memoria caché, apli- 
que el método ToList a la consulta. Ahora, la conexión permanecerá cerrada 
mientras se utilizan los resultados de la consulta. Por ejemplo: 


foreach (var alum in alums.ToList()) 
[ 


EI uaa 
Console.WriteLine(contextoDe0bjs.Database.Connection.State); 
// escribe: Closed 


Propiedades de navegación 


Al importar un modelo relacional, el asistente para el EDM deduce de los metada- 
tos de la base de datos las características de las asociaciones entre entidades y ge- 
nera las correspondientes propiedades de navegación. Por lo tanto, una propiedad 
de navegación da acceso a las entidades que hay en los extremos de la asociación 
que representan. Por ejemplo, en una asociación entre las entidades alumno y 
alum_asig, la entidad alumno puede declarar una propiedad de navegación deno- 
minada alums_asigs para representar los objetos alum_asig asociados a un objeto 
alumno determinado. Resumiendo, desde un objeto alumno o alum_asig, las pro- 
piedades de navegación permiten localizar el objeto en el otro extremo de la aso- 
ciación, lo cual simplifica enormemente las consultas en eSQL. 


En el nodo MDEBDNotasAlums.tt del modelo de datos generado podemos 
observar la clase de entidad alumno que está asociada a la tabla alumnos de la ba- 
se de datos. Esta clase, que representa una fila de la tabla, define por cada colum- 
na de la tabla alumnos una propiedad del mismo nombre, id_alumno y nombre, 
que devuelve o asigna el valor correspondiente al atributo vinculado con la misma 
y una propiedad más, alums_ asigs (llamada “propiedad de navegación”), que de- 
fine la relación entre las tablas, en este caso, entre alumnos y alums_asigs (en la 
primera id_ alumno es la clave primaria que, a su vez, es la clave externa en la se- 
gunda), que devuelve un objeto ICollection<alum_ asig> que se corresponde con 
una secuencia de objetos alum_asig. El ejemplo siguiente muestra cómo, gracias a 
esta propiedad de navegación, es posible acceder a la notas de las asignaturas de 
un alumno de una forma muy simple: 


var actas = 
from alum in contextoDe0bjs.alumnos 
from al_as in .alums_as1gs 


group new { alum. , al_as.nota ) by al_as.id_asignatura; 


CAPÍTULO 14: LINQ 677 


foreach (var grupo in actas) 
( 

Console.WriteLine("AnAsignatura: " 
foreach (var al in grupo) 


Console.Writeline(al.nombre + " " + al.nota); 


+ grupo.Key):; 


Este ejemplo muestra por cada asignatura los alumnos matriculados en la 
misma con sus notas correspondientes. 


Obsérvese que la expresión alum.alums asigs devuelve un objeto ICollec- 
tion<alum_asig> con las asignaturas y notas del alumno alum. 


La propiedad alums_asigs que define la relación entre las tablas alumnos y 
alums_ asigs nos permite para un objeto alumno acceder a los datos que figuran de 
este objeto en la tabla relacionada alums_asigs (relación 1:N). 


Obsérvese la simplificación de la expresión de consulta (asignaturas en las 
que se ha matriculado alum) from al_as in alum.alums_asigs respecto a esta otra, 
que da el mismo resultado: 


join al_as in contextoDe0bjs.alums_asigs 
on alum.id_alumno equals al_as.id_alumno 


Un análisis análogo lo haríamos con respecto a la clase de entidad asignatura. 
Y, ¿qué sucede con la clase de entidad alum_asig? Observamos que esta clase, 
que está asociada a la tabla alums asigs de la base de datos, también define una 
propiedad por cada campo de la tabla y, además, dos propiedades más: alumno y 
asignatura, que definen las relaciones de la tabla alums_asigs con las tablas 
alumnos y asignaturas (en la primera id alumno e id_ asignatura son claves ex- 
ternas y, respectivamente, en las segundas son claves primarias); estas dos propie- 
dades devuelven un objeto TEntidad (alumno o asignatura), a través de una 
referencia, que se corresponde con la entidad del extremo de la relación con mul- 
tiplicidad 1 en este caso. El ejemplo siguiente muestra cómo, gracias a estas dos 
propiedades, es posible acceder a las asignaturas de las que se ha matriculado un 
alumno de una forma muy simple: 


int idAlummo = 1234567; 

var alumAsigs = 
from al_as in contextoDe0bjs.alums_asigs 
where al_as.id_alumno == idAlumno 


group new { NombAsig = al_as.asignatura.nombre } 
by BIEBScaluma. nombre. 


foreach (var grupo in alumAsigs) 
( 
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Console.Writeline("AnAlumno: 
foreach (var x in grupo) 
Console.WriteLine(x.NombAsig):; 


+ grupo.Key); 


Las expresiones al_as.asignatura y al_as.alumno devuelven, respectivamen- 
te, referencias a un objeto asignatura y a otro alumno. 


Las propiedades alumno y asignatura que definen las relaciones entre la tabla 
alums_asigs y las tablas alumnos y asignaturas nos permiten para un objeto 
alum_asig acceder a los datos que figuran de este objeto en la tabla relacionada 
alumnos o asignaturas (relación N:1). 


Otra solución al ejemplo anterior puede ser la siguiente: 


int idAlumno = 1234567; 


var alums = 
from al in contextoDe0bjs.alumnos 
where al.id_alumno == idAlumno 
select al; 
var asigs = 
from al_as in contextoDe0bjs.alums_asigs 
where al_as.id_alumno == idAlumno 


select al_as.asignatura; 


foreach (var alum in alums) 
Console.WriteLine(alum.nombre); 

foreach (var asig in asigs) 
Console.WriteLine(asig.nombre):; 


Mostrar datos en una interfaz gráfica 


Los datos del ejemplo anterior pueden ser fácilmente mostrados en una interfaz 
gráfica como la siguiente: 





K 





a Formi 





Leticia Aguirre Soriano 


PROGRAMACION AVANZADA 
FUNDAMENTOS DE PROGRAMACION 
PROGRAMACION 

PROGRAMACION AVANZADA (OPTATIVA) 
PROGRAMACION VISUAL 
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Dicha interfaz gráfica está formada por un control Label, e£NomAlum, y un 
control List, /istaAsigs. 


Los datos a mostrar, según el ejemplo del apartado anterior, provienen de: el 
nombre del alumno, de la colección alums, y las asignaturas de las que está matri- 
culado, de la colección asigs. Por lo tanto, para mostrar el nombre en el control 
etNomAlum bastaría escribir: 


etNomAlum. Text = alums.First().nombre; 


Y para mostrar la lista de asignaturas en el ListBox bastaría escribir: 


listaAsigs.DataSource = asigs.ToList(); 
listaAsigs.DisplayMember = "nombre"; 


Una aplicación con interfaz gráfica 


El paso siguiente es ver cómo trabaja una aplicación con interfaz gráfica contra la 
base de datos utilizando este modelo de objetos. Como ejemplo, vamos a generar 
una aplicación basada en la última que desarrollamos en el capítulo Enlace de da- 
tos con Windows Forms (proyecto OperacionesConDatos) y así podrá comparar 
las tecnologías utilizadas en una y otra versión. La aplicación, inicialmente, mos- 
trará una interfaz que permita a un alumno acceder a la base de datos para conocer 
la nota obtenida en cualquiera de las asignaturas en las que está matriculado. 





r 











a9 Notas alumnos 





Lista de alumnos: 


1D _ Nombre 
1234561 Isabella Dulce Bella 


| 1234562 Luis Gonzalez Amutia 


m 1234563 Pedro Garcia Rojas 


Leticia Aguirre Soriano 








m 





Lista de asignaturas del alumno seleccionado: 
(9) Todas (O Suspensas (O Aprobadas 
o 
FUNDAMENTOS DE PROGRAMACION 





PROGRAMACION AVANZADA (OPTATIVA) 
PROGRAMACION VISUAL 


«| m | + 











Nota del alumno y asignatura seleccionados: 
g5 
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A la vista de la interfaz anterior, el alumno seleccionará su nombre en la pri- 
mera lista (este control muestra los nombres de la tabla alumnos), lo que hará que 
se muestren en la otra lista las asignaturas de las que está matriculado. Después, 
seleccionará la asignatura de la cual quiere conocer la nota y esta le será mostrada 
en un control de texto. 


Continuando con el proyecto anterior, construya la interfaz gráfica (capa de 
presentación), tal como muestra la figura anterior, en la que distinguimos, además 
de las etiquetas, un control DataGridView denominado dgAlumnos, tres Radio- 
Button denominados bopTodas (con su propiedad Checked igual a true), 
bopSuspensas y bopAprobadas, otro DataGridView denominado dgAsignaturas 
y un TextBox denominado ctNota de solo lectura. 


Vincular los controles con sus orígenes de datos 


La rejilla de Alumnos mostrará la lista de alumnos. Por lo tanto, su origen de datos 
será una colección de objetos alumno proporcionada a través de un BindingSour- 
ce por las ventajas que esta forma de proceder reporta, según hemos estudiado en 
capitulos anteriores. Según lo expuesto, desde la caja de herramientas, arrastre un 
control BindingSource, denominelo odAlumnos, y, utilizando el asistente para la 
configuración de orígenes de datos (puede iniciar este asistente desde el menú de 
tareas de este control), configúrelo para que su origen de datos, propiedad Data- 
Source, sean objetos de tipo alumno. Para más detalles, repase el apartado Cons- 
truir componentes de acceso a datos del capítulo Acceso a una base de datos. 





r = al 
Asistente para la configuración de orígenes de datos 0 m 





p- Seleccionar los objetos de datos 


Expanda los ensamblados y los espacios de nombres a los que se hace referencia para seleccionar objetos. Si falta 
un objeto en un ensamblado al que se hace referencia, cancele el asistente y recompile el proyecto que contiene el 
objeto. 


¿A qué objetos desea enlazar? 





OE ApEntidades | Agregar referencia... 
a EE BDNotasAlumnos 
a E} BDNotasAlumnos 
10% alum_asig 

d Elfs alumno 

10% asignatura 

Eleg bd_notasAlumnosEntities 
DO EntityFramework 

















Después, haga que este odAlumnos sea el origen de datos de la rejilla y perso- 
nalícela según lo enunciado: quite la columna alums_ asigs, establezca los títulos 
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de las columnas, sus anchos, revise los enlaces a datos (propiedad DataPro- 
pertyName de cada columna), etc. 


Realizando un proceso análogo, configure la rejilla dg Asignaturas para que su 
origen de datos sea un BindingSource denominado odAsignaturas que, a su vez, 
tenga como origen de datos objetos de tipo asignatura. 


Y realizando un proceso análogo, configure la caja de texto ctNota para que 
su propiedad Text esté vinculada con la propiedad nota de un origen de datos 
BindingSource denominado odAlumAsig que, a su vez, tenga como origen de da- 
tos objetos de tipo alum_asig. 


Propiedades Ix 
ctNota System.Windows.Forms.TextBox y 
[8] [10] 4 
(ApplicationSettings) = 
E (DataBindings) 

(Avanzado) 














Tag (ninguno) 
A z 
(Name) sl odAsignaturas 2 
AcceptsReti p 1 odAlumnos 


AcceptsTaH 4 1 odAlumAsig 














Accessiblel] E id_alumno A 
AccessibleN E id asignatura F 
AccessibleR E not 

AllowDrop || met” — 
Anchor E asignatura > 











AutoComp] +2 Agregar origen de datos del 


Proveedor de datos 


Ya tenemos generado el modelo de objetos representación de la base de datos, es- 
to es, la capa de acceso a datos (DAL), diseñada la interfaz gráfica y vinculados 
los controles con sus orígenes de datos ficticios. Ahora, partiendo de este modelo, 
crearemos un proveedor de datos para utilizarlo como origen de datos, a través del 
BindingSource correspondiente, en la primera lista, deAlumnos, la que muestra 
los nombres de los alumnos. Para ello, añada una nueva carpeta al proyecto ApEn- 
tidades, denominada por ejemplo BLL, y agregue a la misma la siguiente clase: 


using System.Linq; 
using BDNotasAlumnos; 
namespace ApEntidades 
( 
public class ProveedorDeDatos 
( 
private bd_notasAlumnosEntities contextoDe0bjs; 
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public ProveedorDeDatos() 
( 
contextoDe0bjs = new bd_notasAlumnosEntities(); 


) 


public BindingListView<alumno> ObtenerAlumnos() 
( 
BindingListView<alumno> vista; 
vista = 
new BindingListView<alumno>(contextoDe0bjs.alumnos.ToList()); 
return vista; 


La variable vista hace referencia a un objeto BindingListView que soporta 
las operaciones de ordenación, filtrado y búsqueda, y que se pueda enlazar a un 
DataGridView, según estudiamos en el capítulo Enlace de datos en Windows 
Forms. Dicho objeto lo construimos a partir de la colección que devuelve ToList, 


Un objeto de la clase ProveedorDeDatos será el proveedor de datos para el 
formulario Form1 y su método ObtenerAlumnos proveerá de datos, indirectamen- 
te, al DataGrid deAlumnos. Dicho proveedor será un atributo, provDatos, del 
formulario, según se indica a continuación: 


namespace ApEntidades 
( 
public partial class Forml : Form 
( 
private ProveedorDeDatos provDatos = new ProveedorDeDatos():; 


public Forml() 
( 
InitializeComponent(); 
odAlumnos.DataSource = provDatos.ObtenerAlumnos(); 


Observe que el método ObtenerAlumnos de provDatos proporciona la colec- 
ción de alumnos, obtenida de la tabla alumnos, que da lugar al proveedor. Para 
que el DataGrid dgAlumnos muestre los datos ¡d_alumno y nombre de cada uno 
de los objetos alumno de la colección, asignamos dicha colección a la propiedad 
DataSource del objeto od Alumnos, origen de datos del DataGrid, y los atributos 
id alumno y nombre de cada objeto de la colección con sus respectivas columnas 
en el DataGrid (véase en la ventana de propiedades la propiedad Columns de es- 
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te control y obsérvese el valor de la propiedad DataPropertyName de cada una 
de sus columnas). 


Si ejecuta ahora la aplicación, observará cómo la ventana muestra ya la lista 
de alumnos. 


Continuemos con la aplicación. Cuando el usuario seleccione un nombre en la 
primera lista, en la segunda lista deben mostrarse las asignaturas de la tabla asig- 
naturas de las que ese alumno se ha matriculado. ¿Cómo obtenemos esas asigna- 
turas? Pues a través de la siguiente expresión de consulta: 


var asigs = 
from al_as in contextoDe0bjs.alums_asigs 
where al_as.id_alumno == idAlumno 


select al_as.asignatura; 


Observe que en la consulta hay un parámetro variable que se corresponde con 
el identificador idAlumno del alumno seleccionado y que será obtenido, como ve- 
remos un poco más adelante, de la fila seleccionada en el DataGrid dgA/lumnos. 
Cada objeto de la colección asigs es de tipo asignatura y se obtiene a través de la 
propiedad de navegación al_as.asignatura. 


Procediendo de forma análoga a como implementamos ObtenerAlumnos, va- 
mos a añadir otro método a la clase ProveedorDeDatos que nos proporcione la 
colección de objetos producidos por esta consulta. Este método, que vamos a de- 
nominar ObtenerAsignaturas, puede ser así: 


public BindingListView<asignatura> ObtenerAsignaturas(int idAlumno) 
( 


var asigs = 
from al_as in contextoDe0bjs.alums_asigs 
where al_as.id_alumno == idAlumno 


select al_as.asignatura; 
BindingListView<asignatura> vista; 
vista = new BindingListView<asignatura>(asigs.ToList()); 
return vista; 


La colección de asignaturas proporcionada por el método ObtenerAsignatu- 
ras, de tipo BindingListView, corresponde al alumno seleccionado y será el ori- 
gen de datos para el segundo DataGrid, deAsignaturas, de la interfaz gráfica, 
utilizando como intermediario el control BindingSource odAsignaturas. 


Por lo tanto, para que el DataGrid deAsignaturas muestre los datos id_asig- 
natura y nombre de cada uno de los objetos de la colección devuelta por el méto- 
do ObtenerAsignaturas de provDatos, tenemos que asignar dicha colección a la 
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propiedad DataSource del objeto odAsignaturas, origen de datos del DataGrid, y 
los atributos id_asignatura y nombre de cada objeto de la colección con sus res- 
pectivas columnas en el DataGrid. 


Ahora bien, la colección a la que nos hemos referido en el párrafo anterior 
cambia para cada alumno seleccionado. Según esto, ¿cuándo asignamos la colec- 
ción al origen de datos odAsignaturas? Pues cada vez que el usuario seleccione un 
nuevo nombre en el DataGrid degAlumnos. ¿Y dónde hacemos esa asignación? 
Cuando el usuario selecciona un alumno (una fila), se genera el evento Selec- 
tionChanged de deAlumnos; será, entonces, el método que responda a este even- 
to el que obtenga la colección de asignaturas correspondiente al alumno 
seleccionado y el que la asigne al control od Asignaturas, origen de datos del Da- 
taGrid. Por lo tanto, añada este método a Form1 y complételo así: 


private void dgAlumnos_SelectionChanged(object sender, EventArgs e) 
( 
ObjectView<alumno> al = odAlumnos.Current as ObjectView<alumno>; 
if (al == null) return; 
idAlumnoActual = al.Object.id_alumno; 
vistaAsignaturas = provDatos.ObtenerAsignaturas(idAlumnoActual); 
odAsignaturas.DataSource = vistaAsignaturas; 


El código anterior requiere declarar los siguientes atributos en la clase Form] 
a la que pertenece el método: 


BindingListView<asignatura> vistaAsignaturas; 
public int idAlumnoActual'; 


Ahora el DataGrid dgAsignaturas ya muestra el nombre de las asignaturas en 
las que se ha matriculado el alumno seleccionado. Pues bien, cuando el usuario 
seleccione una de las asignaturas mostradas, se tiene que visualizar la nota corres- 
pondiente a esa asignatura en el TextBox ctNota que hemos colocado en el fondo 
de la ventana. Para obtener la nota correspondiente al alumno y asignatura selec- 
cionados haremos una nueva consulta como la siguiente: 


var alumAsig = 
from al_as in contextoDe0bjs.alums_asigs 
where al_as.id_alumno == idAlumno 44 
al_as.id_asignatura == idAsignatura 
select al_as; 


Observe que en la consulta hay dos parámetros variables (¡dAlumno e idAsig- 
natura), que serán obtenidos de las filas seleccionadas en ambos DataGrid. En 
este caso, la colección alumAsig contendrá un solo objeto de tipo alum_asig. 
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Según lo expuesto, vamos a añadir otro método a la clase ProveedorDeDatos 
que devuelva la colección de objetos producidos por esta otra consulta. Este mé- 
todo, que vamos a denominar ObtenerAlumAsig, puede ser así: 


public BindingListView<alum_asig>» ObtenerAlumAsig(int ¡idAlumno, 
int idAsignatura) 
( 
var alumAsig = 
from al_as in contextoDe0bjs.alums_asigs 
where al_as.id_alumno == idAlumno 44 
al_as.id_asignatura == idAsignatura 
select al_as; 
BindingListView<alum_asig> vista; 
vista = new BindingListView<alum_asig>(alumAsig.ToList()); 
return vista; 


La acción de seleccionar un elemento en el DataGrid deAsignaturas hace 
que se genere el evento SelectionChanged. Entonces, el método que responda a 
este evento será el que obtenga la colección devuelta por la consulta anterior y la 
asigne al control odAlumAsig, origen de datos de este DataGrid. Por lo tanto, 
añada este método a Forml y complételo así: 


private void dgAsignaturas_SelectionChanged(object sender, 
EventArgs e) 
( 
ObjectView<asignatura> asig = 
odAsignaturas.Current as ObjectView<asignatura»>; 
if (asig == null) return; 
idAsignaturaActual = asig.Object.id_asignatura; 
odAlumAsig.DataSource = 
provDatos.ObtenerAlumAsig(idAlumnmoActual, idAsignaturaActual); 


Como el atributo nota del origen de datos odAlumAsig está vinculado con la 
propiedad Text de ctNota, cada vez que seleccionemos una nueva asignatura, se 
actualizará este origen de datos con la nueva asignatura, según se puede observar 
en el método anterior, y la caja de texto mostrará la nota correspondiente. 


El código anterior requiere declarar el siguiente atributo en la clase Form] a 
la que pertenece el método: 


public int idAsignaturaÁActual; 
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Filtros 


Según estudiamos en el capítulo Enlace de datos en Windows Forms, la clase 
BindingListView, del espacio de nombres Equin.ApplicationFramework, permite 
construir una vista (de una colección que implemente la interfaz IList) que sopor- 
ta las operaciones de ordenación, filtrado y búsqueda, y que se puede enlazar a un 
DataGridView. Según esto, vamos a aplicar filtros personalizados para que solo 
se muestren ciertas filas. Como ejemplo, vamos a dotar de funcionalidad a los tres 
botones de opción que añadimos durante el diseño al formulario para permitir al 
usuario mostrar todas las asignaturas del alumno seleccionado, las asignaturas que 
tiene suspensas o las asignaturas que tiene aprobadas. Para ello, simplemente ten- 
dremos que controlar el evento CheckedChanged de cada uno de ellos y estable- 
cer en la vista el filtro adecuado para que solo se muestren las filas deseadas. Así, 
para mostrar solo las asignaturas suspensas, el filtro que tendríamos que aplicar a 
la vista desde el controlador del evento CheckedChanged del botón bopSuspen- 
sas sería el siguiente: 


private void bopSuspensas_CheckedChanged(object sender, EventArgs e) 
( 
if ClodAsignaturas.SupportsFiltering) return; 
1f (bopSuspensas.Checked == true) 
( 
vistaAsignaturas.ApplyFilter(delegatelasignatura asig) 
( 
return provDatos.ObtenerNota(idAlumnoActual, 
asig.id_asignatura) < 5.0F; 
TE 


Obsérvese que el filtro permite (valor true) que se muestren las asignaturas 
cuya nota sea inferior a 5.0. La nota de cada una de las asignaturas la obtendremos 
por medio del método ObtenerNota que añadiremos a la clase ProveedorDeDa- 
tos. Para ello, es necesario pasar como argumento el identificador del alumno se- 
leccionado y el identificador de cada una de las asignaturas de la vista. 


public float ObtenerNota(int idAlumno, int idAsignatura) 
{ 
var alumAsigs = 
from al_as in contextoDe0bjs.alums_asigs 
where al_as.id_alumno == idAlumno 44 
al_as.id_asignatura == idAsignatura 
select al_as.nota; 
return alumAsigs.First(); 
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Siga un proceso análogo para filtrar las asignaturas aprobadas. Y finalmente, 
una vez aplicado un filtro, volver a mostrar todas las asignaturas de la vista supo- 
ne quitar el filtro, operación que haremos desde el controlador del evento Che- 
ckedChanged del botón bopTodas: 


private void bopTodas_CheckedChanged(object sender, EventArgs e) 
( 
if (lodAsignaturas.SupportsFiltering) return; 
vistaAsignaturas.RemoveFilter(); 


} 


También, cada vez que el usuario seleccione un nuevo alumno, como se crea 
y se muestra una nueva vista de asignaturas, el botón seleccionado debe ser bop- 
Todas (todavía no se ha aplicado ningún filtro). Para ello, añada la línea de código 
especificada a continuación al método dgAlumnos_SelectionChanged: 


private void dgAlumnos_SelectionChanged(object sender, EventArgs e) 
( 

bopTodas.Checked = true; 

/1 


La aplicación está finalizada. La conclusión final que tenemos que sacar es 
que utilizando Entity Framework hemos sido capaces de acceder a una base de da- 
tos sin necesidad de tener que conocer los proveedores de datos de ADO.NET y el 
lenguaje de consultas SQL. 


Contextos de corta duración 


En la aplicación que hemos iniciado estamos usando un contexto de larga dura- 
ción; en nuestro caso, al ser un atributo de la clase Form1, durará el tiempo que la 
aplicación se esté ejecutando, lo que puede suponer un abuso de recursos difícil 
de soportar en muchas ocasiones. Por eso, puede ser conveniente utilizar contex- 
tos de corta duración, algo habitual, por ejemplo, en aplicaciones distribuidas. La 
forma más habitual de añadir un contexto de corta duración es mediante una sen- 
tencia using. Por ejemplo: 


using (bd_notasAlumnosEntities contextoDe0bjs = 
new bd_notasAlumnosEntities()) 
( 
1! 
} 
La sentencia using utilizada en el código anterior obliga a que la clase 
bd_notasAlumnosEntities implemente la interfaz IDisposable. 
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REALIZAR CAMBIOS EN LOS DATOS 


Los cambios que se efectúen en los objetos que forman la base de datos orientada 
a objetos virtual, imagen del modelo de datos de una base de datos relacional, no 
se aplican a esta última hasta que se llame explícitamente al método SaveChan- 
ges de ObjectContext/DbContext. 


Puede verificarlo en el proyecto anterior (pensando en una versión de esta 
aplicación para alumnos no tiene sentido permitir modificaciones, pero sí tiene 
sentido pensando en una versión para el profesor; desde este punto de vista puede 
incluso cambiar la propiedad ReadOnly de la caja de texto c£Nota a true). Ejecu- 
te la aplicación, realice algunos cambios, cierre la aplicación y vuelva a ejecutarla. 
Observará que los cambios no se han guardado. Para que se guarden hay que in- 
vocar al método SaveChanges. ¿Dónde? Un lugar idóneo puede ser desde el con- 
trolador del evento FormClosing de Form]: 


private void Forml_FormClosing(object sender, FormClosingEventArgs e) 
( 
provDatos.SalvarCambios(); 


} 


Añada el método SalvarCambios a la clase ProveedorDeDatos del proyecto: 


public void SalvarCambios() 
( 

contextoDe0bjs.SaveChanges(); 
) 


Si vuelve a realizar la prueba anterior, observará que los cambios ahora sí 
persisten. 


Al llamar a SaveChanges se desencadena el siguiente proceso: 


1. EF examina el conjunto de objetos para determinar si ha habido cambios (los 
servicios de objetos realizan el seguimiento de los cambios realizados en estos 
objetos). Si hubo cambios, los objetos con cambios que dependen de otros se 
ordenan según sus dependencias. 


2. EF inicia una transacción para encapsular la serie de órdenes individuales. 


3. Los cambios en los objetos se convierten uno a uno en sentencias SQL y se 
envían al servidor. En este punto, cualquier error detectado por el gestor de la 
base de datos hace que se detenga el proceso de envío, se inicie una excepción 
y se reviertan todos los cambios de la base de datos, como si no se hubiese 
enviado nada. Además, como ObjectContext mantiene un registro completo 
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de todos los cambios, se puede intentar corregir el problema y llamar de nue- 
vo a SaveChanges. Para cada objeto y relación de un contexto determinado, 
EF crea una estructura de datos, objeto de la clase ObjectStateEntry, para 
almacenar su estado y hacer el seguimiento de los cambios. Este conjunto de 
estructuras está accesible a través de la propiedad ObjectState Manager del 
contexto de objetos. 


El siguiente ejemplo muestra de una forma genérica cómo llevar a efecto los 
cambios sobre una base de datos. Primero se realiza la consulta y después se ha- 
cen los cambios (modificar, añadir o borrar) sobre los resultados obtenidos para, a 
continuación, enviar esos cambios a la base de datos. Cuando una consulta se eje- 
cuta dentro de un contexto de objetos, los objetos devueltos se asocian automáti- 
camente a dicho contexto de objetos. 


using (bd_notasAlumnosEntities contextoDe0bjs = 
new bd_notasAlumnosEntities()) 
( 
// Consulta/nuevo objeto 
/1 


try 
{ 
// Realizar cambios sobre la consulta obtenida 
E EEEN 
// Cambios realizados: 
ObjectStateManager osm = contextoDe0bjs.ObjectStateManager; 


string sCambios = "Modificados: " + osm.GetObjectStateEntries( 
EntityState.Modified).Count().ToString() + 
", añadidos: " + osm.GetObjectStateEntries( 


EntityState.Added).Count().ToString() + 
y borrados: " + osm.GetObjectStateEntries( 
EntityState.Deleted).Count().ToString(); 
Console.WriteLine(sCambios); 











// Enviar los cambios a la base de datos 

int nCambios = contextoDe0bjs.SaveChanges(); 
Console.WriteLine("Se realizaron " + nCambios.ToString() + 
" cambios"); 





) 

catch (OptimisticConcurrencyException ex) 

( 
MessageBox.Show("Error: " + ex.Message); 
// Alternativa: hacer ajustes e intentarlo otra vez 
contextoDe0bjs.Refresh(RefreshMode.ClientWins, consulta); 
contextoDe0bjs.Savelhanges(); 

) 

catch (Exception ex) 


( 
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MessageBox.Show("Error: 
) 


+ ex.Message); 


} 


Cuando no se han realizado cambios, los resultados en sCambios serán de la 
siguiente manera: Modificados: 0, añadidos: 0 y borrados: 0, y nCambios (núme- 
ro de objetos que tenían el estado Modified, Added o Deleted cuando se llamó al 
método SaveChanges) valdrá cero. 


El método SaveChanges sin argumentos ejecuta las sentencias adecuadas pa- 
ra intentar implementar los cambios en la base de datos. Si ocurre un error se pro- 
cede como se ha indicado anteriormente en el punto 3. Hay otra versión, con un 
argumento (true o false). Un valor true indica que se restablezca el seguimiento 
de cambios en el contexto de objetos (es el valor por omisión) y un valor false 
obligaría a llamar al método AcceptAllChanges después de SaveChanges. 


Antes de que se ejecute el método SaveChanges, se genera el evento Sa- 
vingChanges, lo que permitirá implementar, cuando sea necesario, la lógica de 
negocio personalizada antes de que se guarden los cambios en la base de datos. 


Según sabemos por lo explicado hasta ahora, a partir de la versión 4.1 de En- 
tity Framework (con VS 2012 ya estaba disponible la versión 5.0 y se estaba tra- 
bajando sobre la 6.0), se añadieron nuevas API. De ahí que hayamos venido 
utilizando DbContext como contexto de objetos y DbSet<TEntity> como conjun- 
to de entidades. A estas mejoras hay que añadir también una simplificación de 
ObjectState Manager proporcionada por la propiedad ChangeTracker y por el 
método Entry de DbContext. 


ChangeTracker proporciona acceso a las características del contexto que tie- 
nen que ver con el seguimiento de cambios en las entidades, y Entry<TEntity> 
(hay también una versión no genérica) devuelve un objeto DbEntityEn- 
try<TEntity> para la entidad dada, que proporciona acceso a la información de la 
misma y la posibilidad de realizar acciones en ella, ofreciendo muchas más carac- 
terísticas que ObjectStateEntry. 


El siguiente ejemplo, igual que el anterior, muestra de una forma genérica 
cómo llevar a efecto los cambios sobre una base de datos. Ahora el contexto de 
objetos está definido por DbContext en contraposición a ObjectContext. 


using (bd_notasAlumnosEntities contextoDe0bjs = 
new bd_notasAlumnosEntities()) 
( 
// Consulta/nuevo objeto 
// 
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// Realizar cambios sobre la consulta obtenida 
EP 
// Cambios realizados: 
int modified = 0, added = 0, deleted = 0; 
foreach (var objDbEntityEntry in contextoDe0bjs.ChangeTracker.Entries()) 
( 


if (objDbEntityEntry.State == EntityState.Modified) modified++; 


if (objDbEntityEntry.State == EntityState.Added) added++; 
if (objDbEntityEntry.State == EntityState.Deleted) deleted++; 








) 








string sCambios = "Modificados: " + modified + 
", añadidos: " + added + 
" y borrados: " + deleted; 


Console.Writeline(sCambios):; 


// Enviar los cambios a la base de datos 
bool errorSaveChanges; 
do 
( 
errorSaveClhanges = false; 
try 
( 
int nCambios = contextoDe0bjs.SaveChanges(); 
Console.WriteLine("Se realizaron " + nCambios.ToString() + 
" cambios"); 


) 
catch (DbUpdateConcurrencyException ex) 
( 
MessageBox.Show("Error: " + ex.Message); 
// Alternativa: hacer ajustes e intentarlo otra vez 
errorSaveChanges = true; 
var objDbEntityEntry = ex.Entries.Single(); 
objDbEntityEntry.Reload(); 
) 
catch (Exception ex) 
( 
MessageBox.Show("Error: 
) 
) 


while (errorSaveChanges):; 


} 





+ ex.Message); 


Más adelante estudiaremos cómo gestionar los problemas de concurrencia, 
que es a lo que corresponde la última parte de este ejemplo, tanto utilizando el 
contexto de objetos ObjectContext como DbContext, aunque la tendencia es uti- 


lizar este último por las facilidades que presenta. 
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A continuación, vamos a exponer cómo se implementan las modificaciones de 
filas de una tabla, las inserciones de filas y el borrado de las mismas. Para probar 
dichas operaciones, vamos a diseñar una aplicación como la siguiente: 
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Esta nueva aplicación la vamos a construir, con muy poco esfuerzo, a partir 
de la anterior. Sólo tiene que cambiar los controles DataGridView por controles 
ListBox (los denominaremos /stAlumnos y IstAsignaturas), quitar los controles 
RadioButton y los controladores y código asociados, e implementar los controla- 
dores para el evento SelectedIndexChanged de las listas para que sustituyan, eje- 
cutando el mismo código, a los controladores para el evento SelectionChanged 
de los controles DataGridView. La lista /stAlumnos tendrá como origen de datos 
odAlumnos, la lista IstAsignaturas tendrá como origen de datos odAsignaturas 
(obsérvese que son los mismos que los de las rejillas a las que reemplazan), am- 
bas mostrarán la propiedad nombre, y guardarán como valor el identificador co- 
rrespondiente de los objetos de su origen de datos; la caja de texto, de solo lectura, 
no cambia. Eliminamos también el controlador del evento FormClosing de 
Forml. Si ahora ejecuta la aplicación, observará que todo funciona como espera- 
mos. Este cambio de interfaz ha sido así de sencillo por mantener la capa de la ló- 
gica de negocio desacoplada de la capa de presentación. 


Vamos a realizar también algunos cambios en la capa de la lógica de negocio; 
concretamente en la clase ProveedorDeDatos, con la intención de utilizar contex- 
tos de corta duración en todos los métodos, según muestra el ejemplo siguiente: 


public class ProveedorDeDatos 
( 
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// 
public BindingListView<asignatura> ObtenerAsignaturas(int ¡idAlumno) 
( 
using (bd_notasAlumnosEntities 
contextoDe0bjs = new bd_notasAlumnosEntities()) 
( 


var asigs = 
from al_as in contextoDe0bjs.alums_asigs 
where al_as.id_alumno == idAlumno 


select al_as.asignatura; 
BindingListView<asignatura> vista; 
vista = new BindingListView<asignatura>(asigs.ToList()); 
return vista; 


) 
1/ 


A continuación, para exponer cómo implementar las operaciones de modifi- 
car, añadir y borrar una fila en una determinada tabla, añada al formulario la barra 
de menús, con los menús y las opciones que muestra la figura anterior. El menú 
Archivo tendrá un solo elemento Salir, y el menú Cambios en la BD tendrá cuatro 
elementos: Modificar nota, Insertar, Borrar y Matricular. A su vez, Insertar ten- 
drá los elementos Alumno y Asignatura, y Borrar, también. En la carpeta 
Capl4\Cambios en los datos del CD que acompaña al libro puede ver el ejercicio 
completo. 


Modificar filas en la base de datos 


Puede actualizar las filas de una base de datos modificando los valores de los 
miembros de los objetos asociados a la colección de objetos clase entidad que 
devuelve la consulta DbQuery<c/ase_entidad> y, después, enviando los cambios 
a la base de datos. Recuerde que DbQuery implementa la interfaz IQueryable<7> 
que provee la funcionalidad necesaria para evaluar consultas con respecto a un 
origen de datos. 


Para actualizar una fila de la base de datos, siga estos pasos: 


p< 


Realice una consulta para obtener la fila a modificar. 
2. Ejecute la consulta y cambie los valores de las columnas implicadas. 
3. Envíe los cambios a la base de datos. 


El siguiente método busca en la tabla alums_asigs la fila (objeto alum_asig) 
correspondiente al alumno y asignatura especificados y modifica la nota, salvando 
después los cambios en la base de datos. La variable consulta representa una con- 
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sulta y es de tipo IQueryable<alum_asig>. Añada este método, ModificarNota, a 
la clase ProveedorDeDatos y codifíquelo como se indica a continuación: 


public void ModificarNota(int idAlum, int idAsig, float notaAlum) 


( 


using (bd_notasAlumnosEntities 


( 


contextoDe0bjs = new bd_notasAlumnosEntities()) 


// Consulta para obtener la fila a modificar 
var consulta = 
from al_as in contextoDe0bjs.alums_asigs 
where al_as.id_alumno == idAlum 24 
al_as.id_asignatura == idAsig 
select al_as; 


if (consulta.Count() == 0) 

( 
MessageBox.Show("La consulta no contiene elementos”); 
return; 


) 


// Ejecutar la consulta y cambiar los valores 

// de las columnas implicadas 

foreach (alum_asig al_as in consulta) 
al_as.nota = notaAlum; 


// Enviar los cambios a la base de datos 

try 

( 
contextoDe0bjs.SaveChanges(); 
MessageBox.Show("Cambios realizados"); 

) 

catch (Exception ex) 

( 
MessageBox.Show(ex.InnerException.Message); 


) 


Este método será invocado desde el controlador de la orden Modificar nota 


del menú Cambios en la BD. Añada este controlador e impleméntelo como se 
muestra a continuación: 


private void CambiosModificar_Click(object sender, EventArgs e) 


( 


// Obtener los datos 
int idAlum = 1234567; 
int idAsig = 20590; 
float notaAlum = 7.7F; 
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provDatos.ModificarNota(idAlum, idAsig, notaAlum); 
lIstAsignaturas_SelectedIndexChanged(lstAsignaturas, null); 


} 


Evidentemente, en una aplicación real, los datos implicados en la operación 


(sección Obtener los datos) serán introducidos por el usuario, por ejemplo, a tra- 
vés de una caja de diálogo, según puede ver en el apartado de Ejercicios resueltos. 


La última línea del método CambiosModificar_Click invoca al controlador 


IstAsignaturas SelectedIndexChanged para actualizar el origen de datos odAlum- 
Asig de la caja de texto que muestra la nota. 


Insertar filas en la base de datos 


Para insertar filas en una base de datos, se agregan los objetos correspondientes a 
las mismas al conjunto de entidades especificado del contexto de objetos y des- 
pués se envían los cambios a la base de datos. 


Para insertar una fila en la base de datos siga estos pasos: 


Cree un nuevo objeto que incluya los datos de esa fila. Para ello, utilice un 
iniciador de objeto. 


Agregue el nuevo objeto al contexto de objetos. Para ello, el contexto facilita 
el método Entry, por medio del cual puede obtener el objeto de seguimiento 
de cambios DbEntityEntry correspondiente y modificar el estado del objeto 
para que sea registrado como añadido (4dded), o, de una forma más fácil, 
añádalo directamente al conjunto de entidades DbSet correspondiente utili- 
zando su método Add. 


Envíe el cambio a la base de datos. 


El siguiente método crea un nuevo objeto de tipo alumno, se asignan los valo- 


res adecuados a sus propiedades y se agrega al conjunto de entidades alumnos. 
Finalmente, se envía el cambio a la base de datos. 


public void AñadirAlumnmo(int idAlum, string nomAlum) 


( 


using (bd_notasAlumnosEntities contextoDe0bjs = 


( 


new bd_notasAlumnosEntities()) 


// Crear un nuevo objeto alumno 
alumno alum = new alumno() 
( 

id_alumno = idAlum, 

nombre = nomAlum 
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// Añadirlo al conjunto de entidades alumnos 
contextoDe0bjs.alumnos.Add(alum); 

// Q bien: 

//contextoDe0bjs.Entry(alum).State = EntityState.Added; 


// Enviar los cambios a la base de datos 

try 

( 
contextoDe0bjs.SaveChanges(); 
MessageBox.Show("Cambios realizados"); 

) 

catch (Exception ex) 

( 
MessageBox.Show(ex.InnerException.Message); 


) 


Observe las dos formas de añadir la entidad alum al conjunto de entidades 
alumnos definido por el contexto de objetos contextoDeObjs. La primera utiliza el 
método Add, como hacemos con cualquier colección de objetos, y la segunda uti- 
liza el método Entry para obtener el objeto DbEntityEntry correspondiente a la 
entidad alum que proporciona acceso a la información de dicha entidad, como es 
el estado (State) al que asignamos el valor Added lo que le permitirá a Save- 
Changes conocer que se trata de una entidad añadida. 


La manipulación del objeto DbEntityEntry da mucha flexibilidad. Por ejem- 
plo, si sabemos de una entidad que ya existe en la base de datos, pero que actual- 
mente no está siendo controlada por el contexto, entonces podemos decirle al 
contexto que dé seguimiento a esa entidad mediante el método Attach de DbSet 
según se indica a continuación. La entidad queda así incluida en el contexto. 


contexto.Entry(entidadExistente).State = EntityState.Unchanged; 


El método AñadirAlumno será invocado desde el controlador de la orden Zn- 
sertar > Alumno del menú Cambios en la BD. Añada este controlador e imple- 
méntelo como se muestra a continuación: 


private void CambioslInsertarAlumno_Click(object sender, EventArgs e) 
( 
// Obtener los datos 
int idAlum = 1234560; 
string nomAlum = "Alberto García Sánchez"; 
provDatos.AñadirAlumno(idAlum, nomAlum); 
odAlumnos.DataSource = provDatos.ObtenerAlumnos():; 
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Como ejercicio, se propone escribir el código necesario para añadir una nueva 


asignatura: método AñadirAsignatura. 


S1 la operación de inserción no tiene sentido, por ejemplo, porque intentamos 


insertar una fila en la tabla alumnos y el identificador del alumno ya existe, se 
elevará la excepción correspondiente. 


Y, ¿cómo añadimos un objeto alum_asig? En este caso se trata de un nuevo 


objeto relacionado con otro objeto del contexto de objetos. Para añadirlo proceda 
de alguna de las dos formas siguientes: 


Para relaciones de uno a varios o de varios a varios, llame al método Add de 
ICollection<7Entidad> y especifique el objeto relacionado. 


Para relaciones de uno a uno o de varios a uno, establezca la propiedad de na- 
vegación de la entidad en el objeto relacionado. 


El siguiente ejemplo crea un nuevo objeto de tipo alum_asig, se asignan los 


valores adecuados, se asignan las relaciones N:1 de este objeto con los objetos 
alumno y asignatura respectivos y se agrega al conjunto de entidades 
alums_asigs. Finalmente, se envía el cambio a la base de datos. 


public void AñadirAlumnoAsignatura(int idAlum, int idAsig) 


( 


using (bd_notasAlumnosEntities contextoDe0bjs = 


( 


ew bd_notasAlumnosEntities()) 


// Consulta para obtener el alumno a matricular 

var consultal = from alum in contextoDe0bjs.alumnos 
where alum.id_alumno == idAlum 
select alum; 





// Consulta para obtener la asignatura de la que se va a matricular 
var consulta2 = from asig in contextoDe0bjs.asignaturas 

where asig.id_asignatura == idAsig 

select asig; 





if (consultal.Count() == || consulta2.Count() == 0) 

( 
MessageBox.Show("El alumno o la asignatura no existen"); 
return; 

) 

alumno alumno = consultal.First(); 

asignatura asignatura = consulta2.First(); 
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// Crear un nuevo objeto alum_asig 
alum_asig al_as = new alum_asig() 
( 
id_alumno = ¡idAlum, 
id_asignatura = idAsig, 
nota = 0.0F 
}; 


// Establecer las relaciones 
al_as.alumno = alumno; // N: 
al_as.asignatura = asignatura; // Nal 
// 0 bien: 
alumno.alums_asigs.Add(al_as); AN 


asignatura.alums_asigs.Add(al_as); // 1:N 


// Añadir el nuevo objeto al conjunto de entidades alums_asigs 
contextoDe0bjs.alums_asigs.Add(al_as); 











// Enviar los cambios a la base de datos 
try 
( 
contextoDe0bjs.SaveChanges(); 
MessageBox.Show("Cambios realizados"); 
) 
catch (Exception ex) 
( 
MessageBox.Show(ex.InnerException.Message); 


) 





Cuando se añade un nuevo objeto secundario, el objeto primario debe existir 


en el contexto de objetos o en el origen de datos antes de llamar a SaveChanges, 
de lo contrario se producirá una excepción InvalidOperationE xception. 


Este método será invocado desde el controlador de la orden Matricular del 


menú Cambios en la BD. Añada este controlador e impleméntelo como se mues- 
tra a continuación: 


private void CambiosMatricular_Click(object sender, EventArgs e) 


( 


// Obtener los datos 
int idAlum 
int idAsig 


1234560; 
34680; 


provDatos.AñadirAlumnoAsignatura(idAlum, idAsig); 


CAPÍTULO 14: LINQ 699 


Borrar filas en la base de datos 


Para eliminar filas de una base de datos, se quitan los objetos deseados de la co- 
lección de objetos clase entidad que devuelve la consulta DbQuery<c/ase_ en- 
tidad> correspondiente y después se envían los cambios a la base de datos. 


EF no admite operaciones de eliminación en cascada. Por lo tanto, si desea 


eliminar una fila de una tabla que tiene restricciones, deberá realizar una de las si- 
guientes tareas: 


Escriba código para eliminar primero los objetos secundarios que impiden que 
se elimine el objeto primario. 


Establezca la regla ON DELETE CASCADE en la restricción FOREIGN 
KEY de la base de datos. 


De acuerdo con el primer punto anterior, para eliminar una fila de la base de 


datos siga estos pasos: 


1. 


Realice una consulta para obtener los objetos secundarios que impiden que se 
elimine el objeto primario. 


Ejecute la consulta para eliminar los objetos secundarios. Para ello, la clase 
DbContext proporciona el método Set, en sus dos versiones: genérico y no 
genérico, que devuelve el conjunto de entidades DbSet para el tipo especifi- 
cado, lo cual permite ejecutar las operaciones CRUD para la entidad dada en 
el contexto, o de una forma más fácil, bórrela directamente del conjunto de 
entidades DbSet correspondiente utilizando su método Remove. Otra solu- 
ción sería marcar esa entidad como Deleted a través del objeto de segui- 
miento de cambios DbEntityEntry correspondiente. La fila correspondiente 
será eliminada del origen de datos cuando se ejecute SaveChanges. 


Realice una consulta para obtener el objeto primario a eliminar. 
Ejecute la consulta para eliminar el objeto primario. 


Envíe los cambios a la base de datos. 


El siguiente ejemplo elimina el alumno especificado. Para ello, busca en la 


tabla alums_asigs las filas correspondientes al alumno (objetos alum_asig) y des- 
pués elimina estos objetos y su objeto primario (de tipo alumno), salvando a con- 
tinuación los cambios en la base de datos. 


public void BorrarAlumno(int idAlum) 


( 
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using (bd_notasAlumnosEntities contextoDe0bjs = 
new bd_notasAlumnosEntities()) 


( 





// Consulta para obtener los objetos secundarios de ¡dAlum 
var consultal = 
from alum in contextoDe0bjs.alums_asigs 
where alum.id_alumno == idAlum 
select alum; 








if (consultal.Count() != 0) 
( 
foreach (var al_as in consultal) 
( 
// Borrar los objetos secundarios 
contextoDe0bjs.alums_asigs.Removel(al_as); 
// 0 bien: 
//contextoDe0bjs.Set<alum_asig>().Remove(al_as); 
// O bien: 
//contextoDe0bjs.Entry(al_as).State = EntityState.Deleted; 


) 


// Consulta para obtener el objeto primario idAlum 

var consulta2 = 
from alum in contextoDe0bjs.alumnos 
where alum.id_alumno == idAlum 
select alum; 





if (consulta2.Count() != 0) 
( 





foreach (var alum in consulta2) 
( 
// Borrar el objeto primario 
contextoDe0bjs.alumnos.Remove(alum); 
) 
) 


if (consultal.Count() == 0 48 consulta2.Count() == 0) 

( 
MessageBox.Show("La consulta no contiene elementos”); 
return; 

) 

// Enviar los cambios a la base de datos 

try 

( 
contextoDe0bjs.SaveChanges(); 
MessageBox.Show("Cambios realizados"); 

) 

catch (Exception ex) 

( 
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MessageBox.Show(ex.InnerException.Message); 
) 


Este método será invocado desde el controlador de la orden Borrar > Alumno 
del menú Cambios en la BD. Añada este controlador e impleméntelo como se 
muestra a continuación: 


private void CambiosBorrarAlumno_Click(object sender, EventArgs e) 


( 
// Obtener los datos 
int idAlum = 1234560; 


provDatos.BorrarAlumno(1dA1um); 
odAlumnos.DataSource = provDatos.ObtenerAlumnos():; 


Como ejercicio, se propone escribir el código necesario para eliminar una 
asignatura que está asignada a un alumno determinado. 


Si quisiéramos realizar operaciones en cascada, tendríamos que establecer la 
regla ON DELETE CASCADE en la restricción FOREIGN KEY de la base de 
datos. Esto, en nuestro caso, lo podemos hacer utilizando el administrador de SQL 
Server. Por ejemplo, si queremos que al borrar un alumno de la tabla alumnos se 
borren también todas las filas correspondientes a este alumno en la tabla 
alums_asigs, es necesario cambiar la Regla de eliminación de la relación de clave 
externa FK_ alums asigs ¡id alumnos en la base de datos SQL Server asignán- 
dole el valor Cascada según muestra la figura siguiente. 
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El código para realizar esta operación sería ahora el siguiente: 


public void BorrarAlumno(int idAlum) 
{ 
using (bd_notasAlumnosEntities contextoDe0bjs = 
new bd_notasAlumnosEntities()) 


// Consulta para obtener el objeto primario idAlum 

var consulta2 
from alum in contextoDe0bjs.alumnos 
where alum.id_alumno == idAlum 
select alum; 





if (consulta2.Count() != 0 
{ 





foreach (var alum in consulta2) 

{ 
// Borrar el objeto primario 
contextoDe0bjs.alumnos.Remove(alum); 


// Enviar los cambios a la base de datos 
try 
{ 
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contextoDe0bjs.SaveChanges(); 
MessageBox.Show("Cambios realizados"); 


1 
J 


catch (Exception ex) 


{ 
MessageBox.Show(ex.InnerException.Message); 


Problemas de concurrencia 


Entity Framework implementa un modelo de concurrencia o simultaneidad opti- 
mista, lo cual significa que durante una sesión de trabajo no se bloquean los datos 
en el origen de datos para que otra sesión simultánea no pueda interferir. El resul- 
tado es que los cambios se guardan en la base de datos sin comprobar la concu- 
rrencia de forma predeterminada. Por lo tanto, para las propiedades de las 
entidades del modelo conceptual que puedan experimentar un alto grado de con- 
currencia, se recomienda definirlas con su atributo ConcurrencyMode igual a fi- 
xed. Cuando una propiedad tiene fijado el modo de concurrencia o simultaneidad, 
el contexto de objetos comprueba si esa columna cambió en la base de datos antes 
de guardar los datos en ella y en el caso de que la columna hubiera cambiado, ge- 
nerará una excepción OptimisticConcurrencyException en el caso de Object- 
Context y una excepción DbUpdateConcurrencyException en el caso de 
DbContext. 


Como ejemplo, sobre un contexto de objetos DbContext vamos a simular dos 
sesiones diferentes trabajando sobre la misma fila de la base de datos con el fin de 
modificar la nota de una asignatura de un alumno: 


public void TestConcurrencia(int idAlum, int idAsig) 
( 
using (bd_notasAlumnosEntities 
contextolDe0bjs = new bd_notasAlumnosEntities(), 
contexto2De0bjs = new bd_notasAlumnosEntities()) 


// SESIÓN 1: contextolDe0bjs 
// Consulta para obtener la fila a modificar 
var consultal = 
from al_as in contextolDe0bjs.alums_asigs 
where al_as.id_alumno == idAlum 22 
al_as.id_asignatura == idAsig 
select al_as; 





// Ejecutar la consulta y cambiar la nota 
consultal.First().nota = consultal.First().nota + 05F; 
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// SESIÓN 2: contexto2De0bjs 
// Obtener los datos: mismo alumno y misma asignatura 
// pero diferente nota 


// Consulta para obtener la fila a modificar 
var consulta? = 
from al_as in contexto2De0bjs.alums_asigs 
where al_as.id_alumno == idAlum 24 
al_as.id_asignatura == idAsig 
select al_as; 





// Ejecutar la consulta y cambiar la nota 
consulta2.First().nota = consulta2.First().nota + 07754; 


/1/ SESIÓN 1: enviar los cambios a la base de datos 
try 
( 
contextolDe0bjs.SaveChanges():; 
1 
$ 
catch (Exception ex) 
( 


MessageBox.Show(ex.InnerException.Message); 


) 


// SESIÓN 2: enviar los cambios a la base de datos 
try 
( 
contexto2De0bjs.SaveChanges():; 
) 
catch (Exception ex) 
( 
MessageBox.Show(ex.InnerException.Message); 
1 
$ 


e Se inicia la sesión 1, se obtienen los datos de una fila determinada y se asigna 
un nuevo valor a la nota. 


e Antes de que la sesión 1 envíe los datos a la base de datos, se inicia la sesión 
2, se obtienen los datos de la misma fila y se asigna un nuevo valor a la nota. 


e  Lasesión 1 envía los datos a la base de datos y se graba la nueva nota. 


e La sesión 2, desconociendo que la nota ha sido modificada en el origen de da- 
tos por otra sesión, envía los datos a la base de datos y se graba la nueva nota. 
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El resultado es la última nota grabada: nota+=0,75. Pero, ¿es esto lo que que- 
ríamos? ¿Qué operación deseamos dar por válida?, nota+=0,5 o nota+=0,75. 


En un caso como el presentado, para poder elegir entre una de las dos opcio- 
nes, la solución pasa por cambiar la propiedad Modo de simultaneidad de la co- 
lumna nota de la entidad alum_asig. Para ello, abra el diseñador de entidades, 
seleccione la columna nota en la entidad alum_asig y cambie su propiedad Modo 
de simultaneidad al valor Fixed según muestra la figura siguiente. 
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También es posible establecer qué propiedades formarán parte de la compro- 
bación de concurrencia utilizando anotaciones: permiten aplicar atributos a las 
clases o a sus miembros (véase más adelante el apartado Anotaciones en datos y 
convenciones predeterminadas). Por ejemplo: 


[ConcurrencyCheck] 
public float nota { get; set; ) 


La anotación ConcurrencyCheck permite marcar una propiedad para incluir- 
la en la comprobación de la concurrencia en la base de datos cuando un usuario 
edita o elimina una entidad. Esto es equivalente a establecer la propiedad Modo de 
simultaneidad (ConcurrencyMode) de una columna de una entidad a Fixed. 


Ahora, en un contexto de objetos de tipo ObjectContext, si hay un conflicto 
de concurrencia (los valores originales, no actuales, de la entidad no coinciden 
con los valores actuales de la base de datos porque estos han sido modificados) en 
la columna nota se generará una excepción OptimisticConcurrencyException 
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(en nuestro ejemplo se producirá en la sesión 2). Para solucionar este conflicto de 
concurrencia, se recomienda llamar al método Refresh(modo-refresco, entidad) 
de ObjectContext. El modo de refresco (RefreshMode) controla cómo se propa- 
gan los cambios: 


e Opción StoreWins. La opción la base de datos gana indica que los cambios 
realizados en la entidad no serán tenidos en cuenta, por lo que serán rempla- 
zados por los valores correspondientes procedentes de la base de datos. 


e Opción ClientWins. La opción el cliente gana indica que los cambios realiza- 
dos en la entidad serán tenidos en cuenta. Por lo tanto, en la siguiente llamada 
a SaveChanges, estos cambios se envían al origen de datos. 


Resumiendo, cuando se produce una excepción OptimisticConcurrencyEx- 
ception, se debe controlar llamando a Refresh y especificando si el conflicto se 
debe resolver prevaleciendo los datos del origen de datos (StoreWins) o los datos 
del objeto del contexto de objetos (ClientWins). 


Según lo expuesto, modifique el código anterior para que, por ejemplo, preva- 
lezcan los datos del origen de datos, según se muestra a continuación: 


// SESIÓN 1: enviar los cambios a la base de datos 
try 
( 
contextolDe0bjs.SaveChanges(); 
) 
catch (O0ptimisticConcurrencyException ex) 
( 
MessageBox.Show(ex.Message):; 


contextolDe0bjs.Refresh(RefreshMode.StoreWins, consultal); 
contextolDe0bjs.SaveChanges(); 
) 


// SESIÓN 2: enviar los cambios a la base de datos 

try 

( 
// La siguiente operación generará una excepción porque 
// los datos en la base de datos han cambiado después de 
// que la sesión 2 los obtuviera 
contexto2De0bjs.SaveChanges(); 

) 

catch (OptimisticConcurrencyException ex) 

( 
MessageBox.Show(ex.Message); 
// El conflicto puede resolverse refrescando el contexto 2 
// aplicando la regla: base de datos gana (StoreWins) 
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contexto2De0bjs.Refresh(RefreshMode.StoreWins, consulta2); 
// y salvando los cambios de nuevo 
contexto2De0bjs.SaveChanges():; 

) 


Cuando se ejecute este código, la sesión 1 grabará nota+=0,5 en la base de 
datos y cuando la sesión 2 intente realizar la operación SaveChanges, se verifica- 
rá que la nota ha cambiado respecto de la de partida, por lo que se generará la ex- 
cepción que resolverá el conflicto dando la razón al almacén (base de datos), con 
lo que el resultado será el que había: nota+=0, 5. 


Ahora, en un contexto de objetos de tipo DbContext, que es el caso que nos 
ocupa, si hay un conflicto de concurrencia en la columna nota se generará una ex- 
cepción DbUpdateConcurrencyException (en nuestro ejemplo se producirá en 
la sesión 2). Para solucionar este conflicto de concurrencia, se recomienda llamar 
al método Reload del objeto DbEntityEntry correspondiente a la entidad cuyos 
valores originales se han visto alterados. El método Reload vuelve a cargar los 
valores de las propiedades de la entidad seguida por DbEntityEntry con los valo- 
res actuales de la base de datos, pasando su estado a ser Unchanged. 


En este contexto, la opción StoreWins (la base de datos gana) se puede im- 
plementar obteniendo los valores actuales que hay en la base de datos para esta- 
blecerlos como los valores actuales de la entidad sobrescribiendo los cambios que 
se hubieran hecho: 


using (bd_notasAlumnosEntities contextoDe0bjs = 
new bd_notasAlumnosEntities()) 
( 
// Consulta 
// 


// Realizar cambios sobre la consulta obtenida 
// 


// Enviar los cambios a la base de datos 
bool errorSaveChanges; 
do 
( 
errorSaveChanges = false; 
try 
( 
contextoDe0bjs.SaveChanges(); 
) 
catch (DbUpdateConcurrencyException ex) 
( 
errorSaveChanges = true; 
// Actualizar los valores de la entidad que falló 
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// al salvar los cambios, desde la base de datos. 
var objDbEntityEntry = ex.Entries.Single(); 
objDbEntityEntry.Reload(); 
) 
) 
while (errorSaveChanges):; 


} 


Observe que el objeto DbUpdateConcurrencyException tiene una propie- 
dad Entries que hace referencia a los objetos DbEntityEntry correspondientes al 
seguimiento de las entidades que no han podido ser guardadas en la base de datos. 


Y la opción ClientWins (el cliente gana) se puede implementar obteniendo los 
valores actuales que hay en la base de datos para establecerlos como los valores 
originales de la entidad, evitando así que surjan los problemas de concurrencia y 
haciendo que los valores actuales ganen: 


using (bd_notasAlumnosEntities contextoDe0bjs = 
new bd_notasAlumnosEntities()) 
{ 
// Consulta 
/1 


// Realizar cambios sobre la consulta obtenida 
// 


// Enviar los cambios a la base de datos 
bool errorSaveChanges; 
do 
( 
errorSaveChanges = false; 
try 
( 
contextoDe0bjs.SaveChanges(); 
) 
catch (DbUpdateConcurrencyException ex) 
( 
errorSaveChanges = true; 
// Actualizar los valores originales desde la base de datos 
var objDbEntityEntry = ex.Entries.Single(); 
objDbEntityEntry.OriginalValues.SetValues( 
objDbEntityEntry.GetDatabaseValues()); 
) 
) 
while (errorSaveChanges); 


} 
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Observe que la opción cliente gana es muy sencilla de implementar utilizando 
la funcionalidad de la clase DbEntityEntry, cuya misión es proporcionar segui- 
miento a los cambios de las entidades. 


Según lo expuesto, modifique el código anterior para que prevalezcan los da- 
tos del origen de datos según se muestra a continuación: 


// SESIÓN 1: enviar los cambios a la base de datos 
bool errorSaveChanges; 
do 
( 
errorSaveChanges = false; 
try 
( 
contextolDe0bjs.SaveChanges(); 
) 
catch (DbUpdateConcurrencyException ex) 
( 
errorSaveChanges = true; 
// Actualizar los valores de la entidad que falló 
// al salvar los cambios 
var objDbEntityEntry = ex.Entries.Single(); 
objDbEntityEntry.Reload(); 
) 
) 


while (errorSaveChanges); 


// SESIÓN 2: enviar los cambios a la base de datos 
do 
( 
errorSaveChanges = false; 
try 
( 
contexto2De0bjs.SaveChanges(); 
) 
catch (DbUpdateConcurrencyException ex) 
( 
errorSaveChanges = true; 
// Actualizar los valores de la entidad que falló 
// al salvar los cambios 
var objDbEntityEntry = ex.Entries.Single(); 
objDbEntityEntry.Reload(); 
) 
) 


while (errorSaveChanges); 


Cuando se ejecute este código, la sesión 1 grabará nota+=0,5 en la base de 
datos y cuando la sesión 2 intente realizar la operación SaveChanges, se verifica- 
rá que la nota ha cambiado respecto de la de partida, por lo que se generará la ex- 
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cepción que resolverá el conflicto dando la razón a la base de datos, con lo que el 
resultado será el que había: nota+=0,5. Entienda que en un programa real (esto es 
una simulación) habrá un solo bucle do ... while. 


El seguimiento de cambios 


Hemos visto cómo podemos añadir, modificar y suprimir entidades y aplicar estos 
cambios a la base de datos. Pero estas operaciones, según hemos podido compro- 
bar en el apartado anterior, requieren que se realice un seguimiento de los cam- 
bios en el marco de entidades para conocer no solo los valores actuales, sino los 
valores originales y así poder compararlos. Pues bien, este seguimiento es contro- 
lado por un objeto de la clase ObjectState Manager del contexto de objetos. Para 
ello, cada vez que se ejecuta una consulta en el contexto de objetos, por defecto, 
para cada una de las entidades que se obtienen se crea un objeto asociado de la 
clase ObjectStateEntry, para almacenar su estado y hacer el seguimiento de los 
cambios. La figura siguiente muestra los atributos que envuelve cada uno de estos 





objetos: 
UY ITEntityChangeTracker 
ObjectState Manager A ObjectStateEntry A 
Clase Abstract Clase 
(=) 3 
|a Propiedades = Propiedades 
| Æ MetadataWorkspace # CurrentValues 
El Métodos # Entity 
e  ChangeObjectState # aand 
®© ChangeRelationshipState (+ 2 so... e pa e f 
© GetObjectStateEntries # AS 
O  GetObjectStateEntry (+ 1 sobrec... # ObjectStateManager 
iginalVa! 
©  GetRelationshipManager # OriginalValues 
©  ObjectStateManager $ RelationshipManager 
© TryGetObjectStateEntry (+ 1 sob... # State 
O  TryGetRelationshipManager * Métodos 
E Ev 


entos 








Observamos que cada objeto ObjectStateEntry asociado a una entidad pro- 
porciona, básicamente, los valores actuales y los valores originales de las propie- 
dades de esa entidad (objeto o relación: IsRelationship), una referencia (Entity) a 
la entidad representada, la clave de la misma (EntityKey: permite distinguir a la 
entidad del resto), EntitySet obtiene el EntitySetBase del ObjectStateEntry pa- 
ra determinar si este está realizando un seguimiento de un objeto o de una relación 
y el estado de la entidad, así como una referencia al objeto ObjectState Manager 
que la administra. Este último objeto tiene dos métodos interesantes: GetObject- 
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StateEntries(estado) y GetObjectStateEntry(c/ave/objeto). El primero devuelve 
una colección de objetos ObjectStateEntry para las entidades (objetos o relacio- 
nes) que tienen el estado especificado y el segundo devuelve el objeto ObjectSta- 
teEntry correspondiente a la clave de entidad o al objeto especificado. 


Pero, como ya hemos podido ver, a partir de la versión 4.1 de Entity Frame- 
work el contexto de objetos es de tipo DbContext y los conjuntos de entidades 
que este administra son colecciones de objetos de tipo DbSet<TEntity>. También 
hay una simplificación de ObjectState Manager proporcionada por la propiedad 
ChangeTracker y por el método Entry de DbContext. 


D IDisposable 
IObjectContextAdapter 





» | 


DbContext 

Clase 

a 

= Propiedades 
#  ChangeTracker 
# Configuration 


# Database 
= Métodos 
O, DbContext (+ 6 sobrecargas) 
© Dispose (+ 1 sobrecarga) 
©  Entry<TEntity> (+ 1 sobrecarga) 
© Equals 
© GetHashCode 
© GetType 
© GetValidationErrors 
%, OnModelCreating 
©  SaveChanges 
© Set<TEntity> (+ 1 sobrecarga) 
®, ShouldValidateEntity 
a  ToString 
(6) 


ValidateEntity 


* 


Como se puede observar en la figura anterior, la clase DbContext proporcio- 
na las propiedades ChangeTracker, Configuration y Database, y una serie de 
métodos entre los que destacamos Entry. 


ChangeTracker nos ofrece una vista mucho más simple de ObjectStateMa- 
nager facilitando el acceso a los objetos DbEntityEntry utilizados para el se- 
guimiento de cambios en las entidades. 
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Configuration permite un acceso rápido y sencillo a la configuración (todas 
las opciones de configuración, como por ejemplo ValidateOnSaveEnabled, están 
a true por defecto) y Database, el trabajo con la base de datos subyacente. 


Y el método Entry<TEntity> (hay también una versión no genérica) devuelve 
el objeto DbEntityEntry<TEntity> que hace el seguimiento de la entidad dada, 
objeto que proporciona acceso a la información de dicha entidad y la posibilidad 
de realizar acciones en ella, ofreciendo muchas más características que Object- 
StateEntry. 


La figura siguiente muestra la funcionalidad de la clase DbEntityEntry: 





| DbEntityEntry A | 
Clase 
a 
= Propiedades 
#  CurrentValues 
# Entity 
X  OriginalValues 
# State 
= Métodos 
Cast<TEntity> 
Collection 
ComplexProperty 
Equals (+ 1 sobrecarga) 
GetDatabaseValues 
GetHashCode 
GetType 
GetValidationResult 
Member 
Property 
Reference 
Reload 
ToString 





0000000000000 


Esta clase permite una rápida y sencilla gestión del estado de las entidades del 
contexto. Si vuelve a echar una ojeada a los ejemplos relativos a DbContext en 
contraposición a ObjectContext expuesto al principio de este apartado, Realizar 
cambios en los datos, comprobará que utilizando DbEntityEntry no hay que bus- 
car o adjuntar un elemento con ObjectState Manager para poder trabajar con él. 
Ahora la propiedad ChangeTracker y el método Entry hacen todo el trabajo. Por 
ejemplo, el siguiente código marca una entidad para que sea eliminada cuando se 
ejecute SaveChanges: 


contextoDe0bjs.Entry(entidad).State = System.Data.EntityState.Deleted; 
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Como se puede observar en la figura anterior, la clase DbEntityEntry pro- 
porciona las propiedades CurrentValues, OriginalValues, Entity y State, y una 
serie de métodos entre los que destacamos Reload y GetDatabaseValues. 


Las propiedades CurrentValues y OriginalValues proporcionan los valores 
actuales y originales, respectivamente, de la entidad que está siendo seguida por el 
objeto DbEntityEntry. La propiedad Entity hace referencia a la entidad a la que 
el objeto DbEntityEntry está haciendo el seguimiento y la propiedad State espe- 
cifica el estado de la entidad seguida (Detached: la entidad existe pero no está 
siendo seguida porque no ha sido añadida al contexto; cuando la entidad ya ha si- 
do añadida al contexto, su estado puede ser Unchanged: la entidad no ha cambia- 
do, Added: la entidad ha sido añadida al contexto, Deleted: la entidad ha sido 
borrada y Modified: la entidad ha sido modificada). El método SaveChanges hará 
uso de este estado para saber cómo proceder con cada entidad. 


El método Reload vuelve a establecer los valores de las propiedades de la en- 
tidad con los valores actuales de la base de datos y fija su estado en Unchanged; 
esto es, Reload obtiene los valores de la base de datos y se los asigna a la entidad: 


// Actualizar los valores de la entidad desde la base de datos 
var ObjDbEntityEntry = ex.Entries.Single(); 
objDbEntityEntry.Reload(); 


Y GetDatabaseValues permite obtener los valores almacenados en la base de 
datos para una entidad, pero solo eso, no se los asigna a la entidad. Por ejemplo: 


// Actualizar los valores originales desde la base de datos 

var objDbEntityEntry = ex.Entries.Single(); 

objDbEntityEntry.OriginalValues.SetValues( 
objDbEntityEntry.GetDatabaseValues()); 


Veamos un ejemplo en el que realizamos una consulta sobre el conjunto de 
entidades alums asigs, modificamos la nota de la entidad obtenida, utilizando el 
administrador de estado recuperamos las entidades que han sido modificadas 
(propiedad State igual a Modified) y mostramos datos relevantes de las mismas 
así como sus valores originales y actuales: 


public void TestEstadoEntidades(int idAlum, int idAsig) 
( 
using (bd_notasAlumnosEntities 
contextoDe0bjs = new bd_notasAlumnosEntities()) 
( 
// Consulta para obtener la fila a modificar 
var consultal = 
from al_as in contextoDe0bjs.alums_asigs 
where al_as.id_alumno == idAlum 22 





714 ENCICLOPEDIA DE MICROSOFT VISUAL CH 


al_as.id_asignatura == idAsig 
select al_as; 


// Ejecutar la consulta y cambiar la nota 
consultal.First().nota consultal.First().nota + 0.5F; 
// Entidades modificadas 
var entidadesModificadas 
from objDbEntityEntry in contextoDe0bjs.ChangeTracker.Entries() 
where objDbEntityEntry.State == EntityState.Modified 
select objDbEntityEntry; 
// Valores originales y actuales 
foreach (var objDbEE in entidadesModificadas) 
( 
string info 
"Tipo del objeto de seguimiento: " + objDbEE.ToString() + 
"\nID alumno: " + (objDbEE.Entity as alum_asig).id_alumno + 
"\nID asignatura: " + (objDbEE.Entity as alum_asig).id_asignatura + 
"\nValores originales -> actuales:1n"; 
DbPropertyValues actuales objDbEE.CurrentValues; 
DbPropertyValues originales objDbEE.OriginalValues; 
int c actuales.PropertyNames.Count(); 
for (int i = 0; i < c; i++) 
{ 














string prop = actuales. 
info += "\t" + original 
actuales.GetVal 


PropertyNames.ElementAt(i); 
es.GetValue<object>(prop) + 
ue<object>(prop) + "\n"; 


a SE 





} 

MessageBox.Show(info); 
} 
// Salvar los cambios en la base de datos 
try 
( 

contextoDe0bjs.SaveChanges(); 
) 
catch (Exception ex) 
( 

MessageBox.Show(ex.Message); 
) 


ChangeTracker.Entries() devuelve los objetos DbEntityEntry correspon- 


dientes a todas las entidades del contexto actual que están siendo monitorizadas. 
De todas ellas, el código anterior selecciona las modificadas y, después, presenta 
algunos valores relacionados con las mismas. El resultado sería el que muestra la 
figura siguiente: 
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f =A 





Tipo del objeto de seguimiento: System.Data.Entity.Infrastructure.DbEntityEntry 
ID alumno: 1234567 
ID asignatura: 20590 
Valores originales -> actuales: 
1234567 -> 1234567 
20590 -> 20590 
7,5 -> 8 

















CODE FIRST: UN NUEVO MODELO DE TRABAJO 


Al utilizar Entity Framework, concretamente la versión 5.0 que incluye Visual 
Studio 2012, observamos que los nuevos modelos de objetos creados con el dise- 
ñador de EF incluyen de forma predeterminada una clase derivada de DbContext 
y una clase de entidad por cada entidad del modelo conceptual. 


No obstante, la forma que hemos utilizado en este capítulo para generar el 
modelo de entidades no es la única, pero quizás sí la más utilizada; se conoce co- 
múnmente como Database First: generar el modelo de entidades a partir de la de- 
finición de un determinado esquema relacional (a partir de una base de datos 
existente). Otra forma sería la conocida como Model First, que consiste en gene- 
rar, partiendo de cero, el modelo de entidades y a partir de este, generar el modelo 
relacional y como consecuencia la base de datos. Estas dos formas de abordar el 
diseño del modelo de entidades tienen en común la herramienta utilizada para 
crear el modelo: el asistente para el EDM (Entity Data Model); si bien este asis- 
tente es una buena herramienta de trabajo, también, en ocasiones, puede presentar 
restricciones por falta de grados de libertad que pudiéramos necesitar en una cons- 
trucción determinada. Pues bien, con el fin de superar en la medida de lo posible 
estos inconvenientes, EF a partir de su versión 4.1 puso a nuestra disposición la 
posibilidad de diseñar nuestro modelo de entidades haciendo uso solamente de 
código, sin necesidad de tener que generar el fichero .edmx para la definición y el 
mapeo de nuestras entidades; esta nueva opción es conocida como Code First. 


Para utilizar las formas Database First y Model First disponemos de herra- 
mientas visuales, según hemos visto en este capítulo, y con Code First podemos 
también crear el modelo de entidades desde cero o partiendo de una base de datos 
existente, manualmente en el primer caso y automáticamente en el segundo. 
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Para poder utilizar Code First es necesario tener instalado el administrador de 
paquetes NuGet (VS 2012 ya lo incluye en su instalación). Una vez instalado, 
puede acceder al mismo desde el menú Herramientas (Administrador de paquetes 
de biblioteca > Administrador de paquetes NuGet para la solución) o bien desde 
el menú contextual del proyecto VS, opción Administrar paquetes NuGet. 


NuGet es una extensión de Visual Studio que hace fácil agregar, eliminar y 
actualizar las bibliotecas y herramientas en los proyectos .NET Framework que 
las utilizan. Cuando se agrega una biblioteca o una herramienta a un proyecto, 
NuGet copia los archivos en ese proyecto y hace automáticamente los cambios 
que sean necesarios en el mismo, tales como la adición de referencias y cambiar el 
fichero de configuración app.config o web.config, y cuando se elimina una biblio- 
teca, NuGet elimina ficheros y revierte los cambios que hizo en el proyecto para 
que todo quede como estaba inicialmente. 


Resumiendo, cuando se trabaja con ADO.NET Entity Framework (en general, 
con un ORM - Object Relational Mapping) la idea es extraer el modelo de entida- 
des a partir de una base de datos existente, o bien crear desde cero dicho modelo 
de entidades sin importarnos si existe o no una estructura relacional subyacente. 
Evidentemente, lo que buscamos es tener un modelo de objetos (clases de objetos, 
estructuras, interfaces, etc.), algo evidente en un lenguaje orientado a objetos. 
También, la forma en que es construido este modelo de objetos (estas clases) tiene 
su importancia; por ejemplo, si piensa en un modelo basado en ObjectContext, 
obtenido a partir del asistente para el EDM, observará que la clase correspondien- 
te a una determinada entidad hereda de EntityObject; por lo tanto, la clase de en- 
tidad, para persistir, necesita de esa tecnología, frente al hecho de que bien 
pudiéramos disponer de clases que no necesiten, por aspectos de infraestructura, 
implementar o heredar de ninguna otra clase, lo que permite no tener que pensar 
en la persistencia. Esta es la razón de que los nuevos modelos de objetos creados 
con el diseñador de EF incluyan de forma predeterminada clases POCO. Por su- 
puesto, las clases generadas bajo la opción Code First son clases POCO. 


El término POCO (Plain Old CLR Object - objetos CLR antiguos o estándar) 
se utiliza para contrastar un objeto simple con otro que esté diseñado para ser uti- 
lizado en un marco de trabajo determinado tal como un componente ORM. Dicho 
de otra forma, un objeto POCO no está comprometido con la herencia o con atri- 
butos necesarios (manteniendo así el principio de ignorancia de la persistencia), 
cosa que sí ocurre cuando el objeto está definido en un marco de trabajo especifi- 
co, ya que este impondrá que la clase del objeto tenga que heredar de otra clase 
determinada y tenga que incluir unos atributos determinados. 
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Aplicando Code First 


Code First define una nueva forma de crear el modelo de entidades haciendo uso 
solamente de código, esto es, sin necesidad de tener que generar el fichero .edmx 
para la definición y el mapeo de esas entidades. Vamos a ver a continuación los 
detalles de esta forma de trabajar con un ejemplo. 


Supongamos que deseamos crear el modelo de entidades que dé lugar a la ba- 
se de datos bd _notasAlumnos que hemos venido utilizando en este capítulo. La 
gran diferencia con respecto a la forma Database First es que ahora empezaremos 
escribiendo directamente las clases que definen el modelo de entidades. 


Para iniciar este ejemplo, vamos a crear un nuevo proyecto denominado Co- 
deFirst. A continuación diseñamos la capa de acceso a datos. Para ello, empeza- 
remos por instalar EF en la aplicación: clic con el botón secundario del ratón 
sobre el nombre del proyecto > Administrar paquetes NuGet > Entity Framework. 
Otra cosa que también tenemos que hacer es verificar que se haya añadido una re- 
ferencia a System.Data.Entity para tener acceso a la funcionalidad proporcionada 
por EF, la cual incluye las operaciones de consulta, inserción, modificación y bo- 
rrado de datos. 


Definir el modelo de entidades 


A continuación vamos a crear las clases de entidad que definirán el modelo de en- 
tidades. Piense en las clases de entidad como si fueran las tablas de la base de da- 
tos. Cada propiedad de estas clases especifica una columna en la tabla 
correspondiente de la base de datos (para más detalles, repase el apartado Acceso 
a una base de datos en este mismo capítulo). 


Para guardar estas clases, vamos a añadir una carpeta al proyecto denominada 
ModeloDeDatos. Después añadiremos a esta carpeta las clases que se muestran a 
continuación. Observe que las clases de entidad son públicas (public) y que las 
propiedades de navegación son virtuales (virtual). 


public class alumno 
( 

public alumno() 

( 
this.alums_asigs = new HashSet<alum_asig>(); 
) 
// Propiedades correspondientes a las columnas de la tabla asociada 
public int id_alummo { get; set; ) 
public string nombre [ get; set; } 

// Propiedades de navegación 
public virtual ICollection<alum_asig» alums_asigs { get; set; } 
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public class alum_asig 


// Propiedades correspondientes a las columnas de la tabla asociada 
public int ¡id_alumno { get; set; } 

public int id_asignatura { get; set; ) 

public float nota { get; set; } 

// Propiedades de navegación 

public virtual alumno alumno { get; set; ) 

public virtual asignatura asignatura { get; set; } 





public class asignatura 








public asignatura() 
( 
this.alums_asigs = new HashSet<alum_asig>(); 
) 
// Propiedades correspondientes a las columnas de la tabla asociada 
public int id_asignatura { get; set; ) 

public string nombre { get; set; ) 
// Propiedades de navegación 
public virtual ICollection<alum_asig» alums_asigs { get; set; } 











} 


La clase alumno representa un alumno (una fila de la tabla alumnos), la clase 
asignatura representa una asignatura (una fila de la tabla asignaturas) y la clase 
alum_asig representa la nota de una asignatura de un alumno (una fila de la tabla 
alum_asig). Todas estas clases son clases POCO. Y un objeto HashSet<T> repre- 
senta un conjunto de objetos (podríamos haber utilizado List<7> en su lugar, pero 
el rendimiento en las búsquedas es peor). 


Definir el contexto de objetos 


Una vez definido el modelo de entidades, lo siguiente es crear el contexto de obje- 
tos que, como sabemos, provee la funcionalidad para consultar y trabajar con las 
entidades como objetos y proporciona acceso a la base de datos para obtener, al- 
macenar o modificar datos. En este ejemplo, este contexto va a estar definido por 
la clase ContextoNotasAlumnos derivada de DbContext de EF: 


using System.Data.Entity; 
public class ContextoNotasAlumnos : DbContext 
( 
public DbSet<alumno> alumnos { get; set; } 
public DbSet<alum_asig>» alums_asigs { get; set; ) 
public DbSet<asignatura» asignaturas { get; set; } 
) 


CAPÍTULO 14: LINQ 719 


Este diseño es suficiente para trabajar con nuestro modelo de entidades y rea- 
lizar las operaciones básicas en bases de datos: crear, leer, actualizar y borrar (del 
original en inglés Create, Read, Update y Delete - CRUD). 


Como ejemplo, vamos a implementar el controlador del evento Load de 
Forml con la intención de probar nuestro modelo de entidades. 


using CodeFirst.ModeloDeDatos; 


namespace CodeFirst 
public partial class Forml : Form 
public Forml() 
InitializeComponent(); 


) 


private void Forml_lLoad(object sender, EventArgs e) 

using (var bd = new ContextoNotasAlumnos()) 
E ir (lbd.Database.Exists()) 

MessageBox.Show("lLa base de datos no existe"); 

E a + bd.Database.Connection.Database); 





Ejecutamos ahora la aplicación (Ctr! +F5) y observamos que se lanza una ex- 
cepción porque fueron detectados uno o más errores de validación durante la ge- 
neración del modelo debido a que las entidades no tienen definida una clave. Lo 
que ha sucedido es que durante la generación del modelo, Code First no ha podi- 
do identificar la clave primaria de las entidades. 


La solución pasa por respetar las convenciones de Code First o utilizar anota- 
ciones. Las anotaciones permiten aplicar atributos a las clases o a sus miembros 
para establecer, de una forma muy sencilla, reglas que se aplicarán en la construc- 
ción del código final de la aplicación o en su ejecución. 


Anotaciones en datos y convenciones predeterminadas 
Code First establece de forma predeterminada una serie de convenciones para es- 


pecificar, por ejemplo, cómo se asigna el nombre a las tablas (TableAttributeCon- 
vention) o cómo identificar la clave primaria (1dKeyDiscoveryConvention); por 
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ejemplo, esta última convención especifica que una propiedad cuyo nombre fina- 
lice con id en minúsculas o mayúsculas (por ejemplo: id o alumnold) será consi- 
derada clave primaria. 


Otra forma de identificar una propiedad como clave primaria es utilizando los 
atributos de anotación de datos (p.e., KeyAttribute, ForeignKeyAttribute o Ta- 
bleAttribute) definidos en los espacios de nombres System.ComponentMo- 
del.DataAnnotations y System.ComponentModel.DataAmnotations.Schema 
(para más detalles sobre estos atributos eche una ojeada a estos espacios de nom- 
bres en la biblioteca MSDN). Por ejemplo: 


[Key] 
public int id_asignatura { get; set; } 


Este ejemplo especifica que id_ asignatura es la clave primaria. Todas las en- 
tidades que van a dar lugar a un conjunto de entidades tienen que tener una clave 
primaria. Según lo expuesto, especifique en cada una de las clases de entidad de 
nuestro ejemplo las propiedades que son claves primarias; esto quiere decir que 
tendrá que añadir una a la clase de entidad alum_asig. 


Para definir una clave externa la explicación es análoga, o seguimos la con- 
vención establecida por Code First, que en este caso es que el nombre de la pro- 
piedad sea “propiedad de navegación”+“clave primaria” (p.e., alumnoid_alumno) 
o simplemente “nombre de la clave primaria” (p.e., id_alumno), o utilizamos los 
atributos de anotación de datos especificando, además, la propiedad de navega- 
ción asociada a esta relación; por ejemplo: 


[ForeignkKey("alumno”)] 
public int id_alummo { get; set; ) 


Y si queremos especificar explícitamente el nombre de la tabla de la base de 
datos a la que se asigna una clase de entidad, procederíamos así: 


[Table("alumnos”)] 
public class alumno { } 


Una vez hayamos hecho estas correcciones, volveremos a ejecutar de nuevo 
la aplicación y observaremos que todo funciona sin problemas. 


Cadena de conexión 


El contexto de objetos que hemos implementado no especifica una cadena de co- 
nexión, ¿por qué? ¿Existe una cadena de conexión predeterminada? Verifiquemos 
esto utilizando la propiedad Database de DbContext. Esta propiedad hace refe- 
rencia a la base de datos que se crea desde el modelo de entidades y proporciona 
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funcionalidad para crear la base de datos siempre, crearla si no existe, borrarla, 
verificar si existe, ejecutar una sentencia SQL, devolver la cadena de conexión, etc. 
Según esto, modifique el controlador del evento Load así: 


private void Forml_Load(object sender, EventArgs e) 
( 
using (var bd = new ContextoNotasAlumnos()) 
( 
MessageBox.Show(bd.Database.Connection.ConnectionString); 
if (!bd.Database.Exists()) 
MessageBox.Show("La base de datos no existe"); 
else 
MessageBox.Show("BD:" + bd.Database.Connection.Database); 


Si ejecutamos de nuevo la aplicación, podremos observar que la cadena de co- 
nexión es la siguiente: 


í ES) 








Data Source=ASQLEXPRESS; Initial 
Catalog=CodeFirst.ModeloDeDatos.ContextoNotasAlumnos;Integrated 
Security=True;MultipleActiveResultSets=True;Application 
Name=EntityFrameworkMUE 




















A dl 





Como vemos, Code First presupone una cadena de conexión basada en SOL 
Server Express y un nombre para la base de datos igual al nombre de la clase que 
define el contexto de datos precedido por el espacio de nombres al que pertenece. 
Este comportamiento está definido en la clase Database, la cual implementa una 
propiedad estática DefaultConnectionFactory (factoría de conexiones utilizada 
al crear un DbComnection desde un nombre de base de datos o desde una cadena 
de conexión) que define por defecto una cadena de conexión basada en SOLEX- 
PRESS y con seguridad integrada, según muestra la figura anterior. 


Para especificar nuestra propia cadena de conexión, simplemente tenemos que 
añadirla al fichero de configuración (app.config), especificando también el nom- 
bre del proveedor de datos, 


<connectionStrings> 
<add name="ECBDNOEASATUMAOS " 
connectionString="Data Source=.\sqlexpress; 
Initial Catalog=BDNotasAlumnos; 
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Integrated Security=True" 


providertane="SYStem:DataSqICTient”/> 


</connectionStrings> 


y pasarla como argumento al constructor de DbContext cuando se cree el contex- 
to de objetos: 


public class ContextoNotasAlumnos : DbContext 
( 
public ContextoNotasAlumnos() 
base("name=ccBDNotasATumnos") 
( 
) 


public DbSet<alumno> alumnos { get; set; } 
public DbSet<alum_asig> alums_asigs { get; set; ) 
public DbSet<asignatura> asignaturas { get; set; ) 


Generar la base de datos 


El siguiente paso es estudiar cómo generar la base de datos y, opcionalmente, có- 
mo iniciarla con una serie de datos de ejemplo. 


Para generar la base de datos, la propiedad Database del contexto nos da ac- 
ceso a los métodos Create y CreatelfNotExists. El primero crea la base de datos 
para el modelo definido en el contexto utilizado y el segundo la crea solo si aún 
no ha sido creada. Por ejemplo, el código siguiente crea la base de datos para el 
modelo definido por el contexto bd, solo si no ha sido ya creada: 


private void Forml_Load(object sender, EventArgs e) 
( 
using (var bd = new ContextoNotasAlumnos()) 
( 
bd.Database.CreatelfNotExists(); 
) 


Cuando se ejecute el método CreatelfNotExists se creará la base de datos 
con todas sus tablas y las relaciones entre las mismas. Por ejemplo, la tabla alum- 
nos será creada por una sentencia SQL similar a la siguiente: 


CREATE TABLE alumnos 

( 
id_alumno int identity(1,1) primary key, 
nombre nvarchar(max) null 

) 
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La propiedad IDENTITY define la columna como una columna de identidad. 
Las columnas de identidad se utilizan normalmente con las restricciones PRI- 
MARY KEY como identificadores de fila únicos de la tabla. En este caso, deben 
especificarse el valor de iniciación y el incremento, o ninguno, en cuyo caso se 
asumen los valores (1,1). Esto quiere decir que cuando se agregue una fila nueva a 
la tabla, el motor de base de datos proporciona un valor incremental único para la 
columna. En nuestro caso el primer id_alumno será 1 y el incremento, 1. 


Para iniciar la base de datos con unos determinados datos, EF proporciona la 
interfaz IDatabaselnitializer<7Context>, la cual proporciona el método Initiali- 
zeDatabase encargado de ejecutar la estrategia para iniciar la base de datos desde 
un contexto determinado. Para facilitar este proceso, el espacio de nombres Sys- 
tem.Data.Entity proporciona algunas implementaciones de esta interfaz. Por 
ejemplo: 


e CreateDatabaselfNotExists<7Context>. Crea y opcionalmente inicia la base 
de datos con datos, solo si la base de datos no existe. Es la estrategia o plan de 
acción que se ejecutará por defecto. 


e DropCreateDatabaseAlways<7Context>. Crea siempre la base de datos y, 
opcionalmente, la primera vez que el contexto es utilizado en el dominio de la 
aplicación, la inicia con datos. 


e DropCreateDatabaselfModelChanges<7Context>. Borra, crea y opcional- 
mente inicia la base de datos con datos, solo si desde la última vez que la base 
de datos fue creada el modelo cambió. 


En todos los casos, para iniciar la base de datos con unos datos determinados, 
hay que crear una clase derivada de alguna de estas y redefinir el método Seed; 
esto es, hay que implementar una estrategia personalizada. Esto quiere decir que 
para iniciar la base de datos la primera vez que se utilice el contexto necesitamos 
ejecutar alguna lógica propia y, además, en nuestro caso, siempre que modifique- 
mos el modelo de entidades. Esto permitirá que los datos ejemplo que se añadan a 
la base de datos, relativos a alumnos, asignaturas y notas, se puedan utilizar de 
inmediato. 


Según lo expuesto y a modo de ejemplo, vamos a añadir a la carpeta Modelo- 
DeDatos del proyecto una nueva clase IniciarBaseDeDatos derivada de Drop- 
CreateDatabaselfModelChanges que redefina el método Seed para que pueble 
las tablas del contexto pasado como argumento con los datos proporcionados (la 
implementación por defecto de este método no hace nada): 


namespace CodeFirst.ModeloDeDatos 
( 
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class IniciarBaseDeDatos 
DropCreateDatabaselfModelChanges<ContextoNotasAlumnos> 
( 
protected override void Seed(ContextoNotasAlumnos contexto) 
( 
ObtenerAlumnos().ForEach(al => contexto.alumnos.Add(al)); 
ObtenerAsignaturas().ForEachlasig => 
contexto.asignaturas.Add(asig)); 
ObtenerNotas().ForEachín => contexto.alums_asigs.Add(n)); 
) 





private static List<alumno> ObtenerAlumnos() 
( 

1/ 
) 


private static List<asignatura> ObtenerAsignaturas() 
( 

Ft 
) 


private static List<alum_asig> ObtenerNotas() 
( 

1/ 
) 


El aspecto de los métodos Obtener... es el siguiente: 


private static List<alumno> ObtenerAlumnos() 
( 

var alums = new List<alumno> 

( 


new alumno 


id_alumno = 1, 
nombre = "Alumno 01" 


new alumno 


id_alumno = 2, 
nombre = "Alumno 02" 








return alums; 


} 
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Como se puede observar, la clase IniciarBaseDeDatos define el plan de ac- 
ción a seguir: iniciar la base de datos la primera vez que se utilice el contexto y 
siempre que modifiquemos el modelo de entidades. 


El siguiente paso será establecer la estrategia de iniciación que hemos imple- 
mentado, para lo cual habrá que invocar al método SetInitializer<7Context> de la 
clase System.Data.Entity.Database. 


private void Forml_Load(object sender, EventArgs e) 
( 
using (var bd = new ContextoNotasAlumnos()) 
( 
Database.Setlinitializer<ContextoNotasAlumnos>( 
new IniciarBaseDeDatos()); 


Ahora bien, SetlInitializer solo le dice a EF qué iniciador tiene que utilizar 
cuando sea necesario acceder a la base de datos, pero no pone en marcha la crea- 
ción de la misma. Esto es, la base de datos se creará de forma automática la pri- 
mera vez que se utilice el contexto; por ejemplo, debido a una consulta como la 
siguiente: 


var alums = 
from al in bd.alumnos 
select al; 


Recuerde, el iniciador no hará nada si la base de datos ya existe y, además, en 
nuestro caso, si el modelo de entidades no ha cambiado. 


También se puede forzar o no su creación invocando al método Initialize de 
Database: 


bd.Database.Initialize(false); 


El método Initialize ejecuta la estrategia IDatabaselnitializer<7Context> 
registrada sobre el contexto especificado por Seed. Si el parámetro pasado es 
true, la iniciación se ejecuta independientemente de si se ha ejecutado o no antes, 
y si es false, la iniciación solo se ejecuta si aún no se ha ejecutado para este con- 
texto, modelo y conexión en este dominio de aplicación. 


Como ejercicio, puede continuar este proyecto para que presente una interfaz 
gráfica igual a la del proyecto realizado en el apartado Acceso a una base de datos 
expuesto anteriormente en este mismo capítulo. 
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Validación de entidades 


Entity Framework, a partir de su versión 4.1, ofrece distintas formas para la vali- 
dación en el lado del cliente o del servidor. Cuando se utiliza Code First, o bien 
otras formas, se pueden especificar las validaciones utilizando anotaciones o la in- 
terfaz de programación Fluent API (interfaz fluida). Las anotaciones, que ya he- 
mos utilizado anteriormente en este mismo capítulo y que no son exclusivas de 
EF, cubren solamente un subconjunto de la interfaz Fluent API. 


Atributos de anotación de datos 


Cuando una aplicación utiliza objetos de datos, a cada clase de objeto o a sus 
miembros se les puede aplicar atributos que especifiquen las reglas de validación 
(atributos de validación), que indiquen cómo se muestran los datos (atributos de 
presentación) o que establezcan las relaciones entre las clases de entidad (atribu- 
tos de modelado de datos). Estos atributos están definidos mediante clases deriva- 
das de ValidationAttribute pertenecientes al espacio de nombres System.Com- 
ponentModel.DataAnnotations. El nombre de la clase es el nombre del atributo 
más el sufijo Attribute; por ejemplo, CustomValidationAttribute. Algunos de 
estos atributos son los siguientes: 


e CustomValidation. Este atributo utiliza un método personalizado public y 
static para la validación. 


[CustomValidation(typeof(clase_del_método), "método”)] 


e Range. Define los valores mínimo y máximo para una entrada. 


[Range(0,10)] 
public float nota { get; set; ) 


S1 el valor que se especifique para la nota está fuera del rango especificado, se 
lanzará una excepción. 


e  RegularExpression. Este atributo permite especificar una expresión regular 
para determinar la entrada válida. Por ejemplo, la siguiente expresión regular 
indica que se admite cualquiera de los rangos de caracteres, caracteres especi- 
ficados y el espacio en blanco (As); también indica que el número de caracte- 
res tiene que estar entre 1 y 32. La combinación del signo @ y las comillas 
especifica que las secuencias de escape no se procesan. 


[RegularExpression(e"[a-zA-Zá-úA-UnÑNulAs](1,32)", ErrorMessage= 
"No se permiten ni números ni caracteres especiales”)] 


e Required. Especifica que se debe proporcionar un valor. 


[Required(ErrorMessage = "Se requiere el nombre")] 


e StringLength. Designa el número de caracteres máximo y mínimo. 
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[StringLength(32, MinimumLength = 3, ErrorMessage = 
"El nombre de tener entre 3 y 32 caracteres”)] 


e DataType. Especifica un tipo de datos determinado. Por ejemplo, el siguiente 
atributo indicaría que el valor del miembro al que se aplica el atributo tiene 
que ser una dirección de correo electrónico. 


[Datalype(Datalype.EmailAddress)] 


e Display. Se aplica a una propiedad para especificar valores que se usarán en 
los elementos de la interfaz de usuario para mejorar la presentación. Más ade- 
lante veremos que el valor de la propiedad Name, del ejemplo siguiente, lo 
utilizaremos como texto para un control Label y el de la propiedad Descrip- 
tion, como el mensaje abreviado a mostrar por un control DescriptionVie- 
wer. 


[Display(Name = "Apellidos y nombre:", Description = 
"Introduzca primero los apellidos y después el nombre.”)] 


e ConcurrencyCheck. Permite establecer qué propiedades formarán parte de la 
comprobación de concurrencia. 
[ConcurrencyCheck] 


public float nota { get; set; ) 


e  KeyAttribute. Permite establecer la propiedad que actuará como clave prima- 
ria. 


[Key] 
public int id_asignatura { get; set; } 


e  ForeignKeyAttribute. Permite establecer la propiedad que actuará como cla- 
ve externa. 
[ForeignKey("alumno”)] 
public int id_alumno { get; set; } 

e TableAttribute. Permite establecer el nombre de la tabla de la base de datos a 
la que se asigna una clase de entidad. 


[Table("alumnos")] 
public class alumno { } 
Para más detalles, recurra a la ayuda proporcionada por la biblioteca MSDN. 


Interfaz fluida 


Las anotaciones solo cubren un subconjunto de la funcionalidad de la interfaz 
fluida, por lo que surgirán escenarios en los que no se puede lograr el objetivo 
perseguido utilizando anotaciones y sí utilizando esta API. Normalmente, la inter- 
faz fluida es accedida desde el método OnModelCreating de DbContext; esto es, 
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habrá que redefinir este método en la clase derivada de DbContext. Por lo gene- 
ral, este método solo se llama una vez, cuando se crea la primera instancia de un 
contexto. Por ejemplo: 


public class ContextoNotasAlumnos : DbContext 


( 


public ContextoNotasAlumnos() 
base("name=ccBDNotasAlumnos") 

( 

) 


protected override void OnModelCreating(DbModelBuilder mb) 
( 

mb.Entity<alum_asig>().ToTable("alums_asigs"); 
) 


public DbSet<alumno> alumnos { get; set; } 
public DbSet<alum_asig» alums_asigs { get; set; ) 
public DbSet<asignatura» asignaturas { get; set; } 


Veamos a continuación algunos ejemplos de utilización de la interfaz fluida. 


HasKey. Este método se utiliza para especificar qué propiedad va a ser la cla- 
ve primaria. 


mb.Entity<alum_asig>().HaskKey(p => p.1d); 


Property. Este método se utiliza para configurar los atributos para cada pro- 
piedad que pertenece a una entidad o a un tipo complejo. El método Property 
se utiliza para obtener un objeto de configuración para una propiedad dada. 
Las opciones en el objeto de configuración son específicas para el tipo que se 
está configurando. Por ejemplo: 

mb.Entity<alumno>().Property(p => p.nombre) 


.HasMaxLength(40) 
.IsRequired(); 


El método HasMaxLength especifica la máxima longitud de la propiedad 
nombre, e IsRequired, que el nombre es requerido. Si se incumple alguno de 
estos requisitos se lanzará una excepción, en este caso, de tipo DbEntityVali- 
dationException. 


IsConcurrencyToken. Este atributo, configurable a través de Property, 
permite establecer las propiedades que formarán parte de la comprobación de 
concurrencia. 


mb.Entity<alum_asig>().Property(p => p.nota).IsConcurrencyToken(); 
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e ToTable. Este método permite especificar el nombre que tendrá la tabla en la 
base de datos. 


mb.Entity<alum_asig>().ToTable("alums_asigs"); 


e HasColumType. Este atributo configurable a través de Property permite es- 
tablecer el tipo para una columna. 


mb.Entity<alumno>().Property(p => p.nombre) 
.HasColumnType("varchar"); 


Estos pocos ejemplos tratan de dar una idea de lo que es la interfaz fluida, pe- 
ro el tema es mucho más amplio, y como se sale de los objetivos de este libro, le 
remito para más detalles a la ayuda proporcionada por la biblioteca MSDN. 


Code First desde una base de datos existente 


Hemos visto cómo crear el modelo de entidades desde cero para después generar 
la base de datos. Con Code First podemos también crear el modelo de entidades 
partiendo de una base de datos existente. Vamos a ver con un ejemplo cómo reali- 
zar esta ingeniería inversa partiendo de la base de datos BDNotasAlumnos que 
acabamos de construir en el apartado anterior. 


Para iniciar este ejemplo, vamos a crear un nuevo proyecto denominado Co- 
deFirstIngInv. A continuación diseñamos la capa de acceso a datos. Para ello, ha- 
ga clic con el botón secundario del ratón sobre el nombre del proyecto y 
seleccione Entity Framework > Reverse Engineer Code First: 


T Reverse Engineer Code First | Entity Framework » 
Customize Reverse Encieer Templates Establecer ámbito aquí 
EN Nueva vista de Explorador de soluciones 


Sh Mostrar en mapa de código 


En el diálogo que se muestra le será solicitado el nombre del servidor y el de 
la base de datos: 
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r 





n 


Después de pulsar el botón Aceptar se instala automáticamente Entity Fra- 
mework en el proyecto, se carga el esquema de la base de datos, se genera el mo- 
delo de entidades representativo del modelo lógico de la base de datos, se genera 
el contexto de objetos y una serie de clases de configuración que establecen las 
correspondencias y relaciones entre ambos modelos. Todas las clases han sido 


n a] 
Propiedades de la conexión o es 








Especifique la información para establecer conexión con el origen de datos 
seleccionado o haga dlic en "Cambiar" para elegir un origen y/o un 
proveedor de datos diferente. 


Origen de datos: 


Microsoft SQL Server (SqlClient) Cambiar... 


Nombre del servidor: 


L 


Asqlexpress X Actualizar 
Conexión con el servidor 


(9) Usar autenticación de Windows 


5 Usar autenticación de SQL Server 


Guardar mi contraseña 


Establecer conexión con una base de datos 


(0) Seleccione o escriba el nombre de la base de datos: 


BDNotasAlumnos - 


) Asociar con un archivo de base de datos: 


Avanzadas... 


| Cancelar | 
J 








Probar conexión 











creadas en la carpeta Models. 


Cadena de conexión 


La cadena de conexión, como era de esperar, está especificada en el fichero de 
configuración (app.config), cadena que especifica también el nombre del provee- 


dor de datos: 
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<connectionStrings> 
<add name=" 
connectionString="Data Source=.1sqlexpress; 
Initial Catalog=BDNotasAlumnos; 
Integrated Security=True; 
MultipleActiveResultSets=True" 


providerName="System.Data.SqlClient" /> 


</connectionStrings> 


Esta cadena de conexión será pasada como argumento al constructor de 
DbContext cuando se cree el contexto de objetos. 


Contexto de objetos 


El contexto de objetos representa una sesión con la base de datos; por lo tanto, 
provee la funcionalidad para consultar y trabajar con las entidades como objetos y 
proporciona acceso a la base de datos para obtener, almacenar o modificar datos. 
En este ejemplo, este contexto ha sido definido así: 


namespace CodeFirstinglnv.Models 
| public partial class BDNotasAlumnosContext : DbContext 
static BDNotasAlumnosContext() 
| Database.SetInitializer<BDNotasAlumnosContext>(null); 
) 


public BDNotasAlumnosContext() 
base("Name=BDNotasAlumnosContext") 

( 

) 


public DbSet<alumno> alumnos { get; set; } 
public DbSet<alums_asigs> alums_asigs { get; set; } 
public DbSet<asignatura» asignaturas { get; set; } 


protected override void OnModelCreating(DbModelBuilder modelBuilder) 

{ 
modelBuilder.Configurations.Add(new alumnoMap()); 
modelBuilder.Configurations.Add(new alums_asigsMap()); 
modelBuilder.Configurations.Add(new asignaturaMap()); 


1 
$ 





Como sabemos, SetInitializer solo le dice a EF qué iniciador tiene que utili- 
zar cuando sea necesario acceder a la base de datos. 
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El constructor BDNotasAlumnosContext pasa la cadena de conexión al cons- 
tructor de la clase base para decirle a Code First cuál es la cadena de conexión 
que tiene que recuperar del fichero de configuración. 


Las propiedades DbSet<TEntity> hacen referencia a las colecciones de enti- 
dades del modelo. Estas colecciones se inician automáticamente cuando se crea 
un objeto de la clase derivada. 


DbModelBuilder se utiliza para asignar clases CLR a un esquema de base de 
datos. Las clases de configuración ...Map utilizan la interfaz fluida para establecer 
las correspondencias y relaciones entre el modelo de entidades y el modelo lógico 
de la base de datos. 


El modelo de entidades 


Piense en las clases de entidad como si fueran las tablas de la base de datos. Cada 
propiedad de estas clases especifica una columna en la tabla correspondiente de la 
base de datos. En el proceso de ingeniería inversa aplicado sobre la base de datos 
BDNotasAlumnos se han generado estas clases: 


public partial class alumno 
( 

public alumno() 

( 
this.alums_asigs = new List<alums_asigs>(); 


) 


public int id_alumno { get; set; } 
public string nombre { get; set; ) 
public virtual ICollection<alums_asigs> alums_asigs { get; set; ) 








public partial class alums_asigs 


public int id { get; set; ) 

public int id_alumno { get; set; } 

public int id_asignatura { get; set; } 

public float nota { get; set; } 

public virtual alumno alumno { get; set; ) 

public virtual asignatura asignatura { get; set; } 





public partial class asignatura 





public asignatura() 
( 


this.alums_asigs = new List<alums_asigs>(); 
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) 


public int id_asignatura { get; set; ) 
public string nombre { get; set; ) 
public virtual ICollection<alums_asigs> alums_asigs { get; set; ) 


La clase alumno representa un alumno (una fila de la tabla alumnos), la clase 
asignatura representa una asignatura (una fila de la tabla asignaturas) y la clase 
alum_asig representa la nota de una asignatura de un alumno (una fila de la tabla 
alum_asig). Todas estas clases son clases POCO. Y un objeto List<7> representa 
un conjunto de objetos. 


Acceder a los datos 


Una vez definida la capa de acceso a datos, vamos a realizar una consulta y mos- 
trar el resultado en un control FlowLayoutPanel que colocaremos sobre el for- 
mulario. Añada este control, flpLista, y configúrelo según se explicó en el 
capitulo Controles y cajas de diálogo para que utilizando controles Label muestre 
el resultado de la consulta según muestra la figura siguiente: 


t 
a Formi Le | 07) e) 


Alumno 01: 
Asignatura 1, 6,5 











Asignatura 2, 8 
Alumno 02: 
Asignatura 1, 7,5 
Asignatura 3, 4 


























Para obtener este resultado, añada el controlador del evento Load del formu- 
lario y complételo con el código que se indica a continuación: 


private void Forml_Load(object sender, EventArgs e) 
( 
using (var bd = new BDNotasAlumnosContext()) 
( 
var alumsAsigs = 
from al_as in bd.alums_asigs 
group new 


( 
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nom_asig = al_as.asignatura.nombre, 
nota_asig = al_as.nota 
) by al_as.alumno.nombre; 


foreach (var grupo in alumsAsigs) 

( 
Label alum = new Label(); 
alum.Width = flpLista.Width - 28; 
alum. Text = grupo.Key + ":"; 
flplLista.Controls.Add(alum); 
foreach (var elem in grupo) 
( 

Label asigNota = new Label(); 

asigNota.Width flpLista.Width - 28; 

asigNota.Text = elem.nom_asig + ", " + elem.nota_asig; 

flpLista.Controls.Add(asigNota); 











Este método realiza una consulta para obtener las asignaturas de las que se ha 
matriculado cada alumno, agrupadas por el nombre del alumno, y por cada 
alumno o asignatura más nota añade un Label al FlowLayoutPanel con el conte- 
nido correspondiente. 


EJERCICIOS RESUELTOS 


1. Modificar la aplicación anterior, “Cambios en los datos”, para que el elemento 
Modificar nota del menú Cambios en la BD muestre una caja de diálogo, como la 
de la figura siguiente, que permita introducir la nota para el alumno y asignatura 
seleccionados en el formulario principal (Forml), datos que utilizaremos para 
modificar en la base de datos la nota de ese alumno en esa asignatura. 





Nota 





Alumno: Leticia Aguirre Soriano 


Asignatura: PROGRAMACION AVANZADA 


Nota: | 








Aceptar Cancelar 











El valor de la caja de texto tendrá que ser validado para garantizar que se trata 
de un número positivo entre 0 y 10 de tipo float. 
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Según lo expuesto, vamos a añadir al proyecto un nuevo formulario (una caja 
de diálogo), denominado ModificarNota, con las propiedades y los controles que 
muestra la figura anterior y que se describen en la tabla siguiente (el diseño de ca- 
jas de diálogo fue expuesto en el capítulo Controles y cajas de diálogo): 


Formulario 


Etiqueta 


Text 

Name 
FormBorderStyle 
AcceptButton 
CancelButton 


Nota 
ModificarNota 
FixedToolWindow 
btAceptar 
btCancelar 


ReadOnly True 
ReadOnly True 
ReadOnly False 
Botón de pulsación Text SiAceptar 
Name btAceptar 
DialogR esult OK 
Botón de pulsación Text S£ Cancelar 


Name btCancelar 
DialogR esult Cancel 


Etiqueta 
Caja de texto 


Etiqueta 
Caja de texto 








Según se observa en la figura anterior, el diálogo ModificarNota mostrará el 
nombre del alumno y de la asignatura cuya nota se quiere modificar, ambos datos, 
más la nota actual, serán pasados desde Form] como argumentos al constructor de 
la clase ModificarNota, y la nota introducida por el usuario será validada al hacer 
clic en el botón Aceptar (si la nota no es válida se conserva la actual) y podrá ser 
accedida por Forml a través de la propiedad Nota que añadiremos a la clase. Se- 
gún esto, implemente la clase ModificarNota como se indica a continuación: 


public partial class ModificarNota : Form 
( 
public float Nota { get; set; } 


public ModificarNota(string nombreAlum, string nombreAsig, float nota) 
( 

InitializeComponent(); 

ctAlum.Text = nombreAlum; 

ctAsig.Text = nombreAsig; 
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Nota = nota; 


) 


private void btAceptar_Click(object sender, EventArgs e) 
( 
float nota = Nota; 
if (Single.TryParse(ctNota.Text, out nota) && nota >= 0 24 nota <= 10) 
Nota = nota; 


¿Cuándo se visualizará esta caja de diálogo? Pues cuando el usuario de la 
aplicación, después de haber seleccionado el alumno y la asignatura correspon- 
dientes a la nota que desea modificar, haga clic en la orden Modificar nota del 
menú Cambios en la BD. Para ello, modifique el controlador del evento Click de 
esta orden como se indica a continuación: 


private void CambiosModificar_Click(object sender, EventArgs e) 
( 
// Mostrar el diálogo para obtener la nota 

if (IstAlumnos.SelectedIndex < 0 || 
lIstAsignaturas.Selectedindex < 0) return; 


ModificarNota formModNota = new ModificarNota( 
IstAlumnos.Text, lstAsignaturas.Text, 
Convert.ToSingle(ctNota.Text)); 











if (formModNota.ShowDialog() == DialogResult.OkK 24 
Convert.ToSingle(ctNota.Text) != formModNota.Nota) 








( 











provDatos.ModificarNota(idAlumnoActual, idAsignaturaActual, 
formModNota.Nota):; 

lIstAsignaturas_SelectedIndexChanged(lstAsignaturas, null); 
) 





} 


Según se puede observar, el método CambiosModificar_Click construye un 
diálogo de la clase ModificarNota pasando como argumentos al constructor el 
nombre del alumno y de la asignatura, y la nota actual; después muestra el diálogo 
y espera a que el usuario introduzca la nota y lo cierre. Si el diálogo se cerró pul- 
sando el botón Aceptar y la nota es diferente a la actual, invoca al método Modifi- 
carNota del proveedor de datos provDatos pasando como argumentos los 
identificadores del alumno y de la asignatura actualmente seleccionados, y la nue- 
va nota a establecer proporcionada por la propiedad Nota del diálogo. 


Pruebe ahora la aplicación y observe que todo funciona perfectamente. En el 
apartado siguiente, Ejercicios propuestos, le será propuesto que complete de for- 
ma análoga el resto de las órdenes del menú Cambios en la BD. 
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EJERCICIOS PROPUESTOS 


1. Realizar una aplicación, fundamentada en la aplicación “Cambios en los datos”, 
desarrollada en el apartado anterior, que permita básicamente cuatro acciones: 


Poner una nota. 

Añadir un alumno. 

Añadir una asignatura. 

Matricular a un alumno de una asignatura. 


an se 


PARTE 











Aplicaciones para Internet 


e ASP.NET 

e Formularios web 

e Servicios web 

e Seguridad de aplicaciones ASP.NET 
e Páginas maestras 


e AJAX 


CAPÍTULO 15 


O F.J.Ceballos/RA-MA 


ASP.NET 


Tradicionalmente, los sistemas corporativos se han venido diseñando utilizando el 
modelo cliente-servidor, entendiendo por “cliente” una aplicación que inicia el 
diálogo con otra denominada “servidor” para solicitarle servicios que esta puede 
atender. La figura siguiente ilustra cómo puede imaginarse este modelo: 


Servidor 


petición «E 


Cliente 








Aplicaciones 
cliente 


Base de datos 





En un modelo cliente-servidor clásico existen dos procesos independientes 
que cooperan para intercambiar información: el definido por el cliente y el defini- 
do por el servidor. Estos dos procesos están ubicados normalmente en máquinas 
diferentes y se comunican entre sí mediante protocolos estándar o particulares. Un 
ejemplo es una aplicación tradicional de bases de datos. En este caso, el software 
que se ejecuta en el cliente recibe del usuario una petición de información y la 
convierte en una consulta que se envía al servidor de bases de datos (BD), que 
responde enviando los datos solicitados al cliente, para que, por ejemplo, los pre- 
sente al usuario. 


Una aplicación cliente-servidor tiene tres componentes fundamentales: pre- 
sentación (interfaz de usuario), lógica de negocio y gestión de datos. Cada uno de 
estos componentes puede estar en el cliente o en el servidor. Por ejemplo, se pue- 
de implementar la presentación en el cliente, la gestión de datos en el servidor, y 
distribuir la lógica de negocio entre el cliente y el servidor, o bien la presentación 
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y la lógica de negocio en el cliente, y la gestión de datos en el servidor, etc. El re- 
sultado es una arquitectura de dos capas de software. 


Actualmente, la lógica de negocio se ha convertido también en un servicio y 
puede residir en cualquier otro servidor, conocido como “servidor de aplicacio- 
nes”, dando lugar a una arquitectura de tres capas: 


Servidor de 


OS Servidor de datos 
aplicaciones 


Base de datos 


Cliente 












Aplicaciones Procesos 
cliente 


Una aplicación diseñada según un modelo de tres capas se divide en presenta- 
ción, lógica de negocio y datos. La capa de presentación contiene todos los ele- 
mentos que constituyen la interfaz con el usuario. Esta capa incluye todo aquello 
con lo que el usuario puede interactuar, como por ejemplo, una interfaz gráfica 
basada en ventanas, un explorador, también llamado navegador, etc. En la capa de 
lógica de negocio se modela el comportamiento del sistema, basándose en los da- 
tos provistos por la capa de datos, y actualizándolos según sea necesario. Esta ca- 
pa describe los distintos cálculos y otros procesos a realizar con los datos. 
Finalmente, la capa de datos representa el mecanismo para el acceso y el almace- 
namiento de la información. Consiste, generalmente, en un gestor de bases de 
datos o de objetos, y el esquema de datos propio de cada aplicación. Las aplica- 
ciones de tres capas tienen mayor capacidad de crecimiento y son más sencillas de 
mantener, dada su naturaleza altamente modular. 


Normalmente, en una arquitectura cliente-servidor multicapa, una petición de 
un cliente a un servidor genera peticiones a otros servidores conectados a través 
de una red. Un símil puede ser una persona (cliente) que solicita a un agente de 
viajes que le organice un viaje de vacaciones. El agente, normalmente a través de 
mayoristas, contacta con hoteles, líneas aéreas, restaurantes, alquiler de coches, 
etc., necesarios para generar un informe para el cliente. 


Es evidente que el modelo cliente-servidor multicapa proporciona servicios de 
forma eficiente, pero el diseño, creación, depuración, distribución y mantenimien- 
to de las aplicaciones son complejos. Pues bien, la plataforma ASP.NET es un 
nuevo modelo diseñado para proporcionar un entorno de ejecución distribuido y 
multicapa (interfaz de usuario, servicios de aplicación y lógica de negocio, y ser- 
vicios de gestión de datos) que resuelve muchos de los problemas complejos a los 
que se enfrentan los desarrolladores que construyen sistemas distribuidos centra- 
dos en la Web a gran escala utilizando diferentes lenguajes, entre los que cabe 
destacar C# y Visual Basic. 
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ASP.NET 


ASP.NET proporciona un modelo de desarrollo web unificado que incluye los 
elementos necesarios para crear aplicaciones web. Se trata de un entorno que 
permite construir aplicaciones en cualquier lenguaje compatible con .NET, como 
CA o Visual Basic; las aplicaciones ASP.NET, igual que todas las aplicaciones 
.NET, son siempre compiladas. Además, .NET Framework está disponible en su 
totalidad para este tipo de aplicaciones, permitiéndoles así interactuar con el sis- 
tema operativo. 


Código fuente a 
C#, VB, otros Compilador JIT 


Código nativo 
(código máquina) 


Código intermedio 
(IL) 





Las aplicaciones ASP.NET se implementan a través de un mecanismo que 
permite a un navegador, o cliente web, acceder a una página web a través de su 
dirección (URL, Uniform Resource Locator). Todas las páginas y demás ficheros 
que componen una aplicación ASP.NET se ponen a disposición de un usuario a 
través de IIS. 






































Clientes web 
À 
y 
Aplicaciones ASP.NET 4 > IIS 
À À 
y 
.NET Framework 
Á 
y y 
Sistema operativo Windows 











Cuando una página de una aplicación ASP.NET implementa código corres- 
pondiente a la lógica de negocio, lo ejecuta a través de .NET Framework, y utili- 
zará IIS para proporcionar el resultado como código HTML al cliente web; si no, 
será IIS quien accederá directamente al sistema operativo para proporcionar el re- 
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sultado. En todos los casos, una aplicación ASP.NET terminará proporcionando 
código HTML a través de IIS para mostrar los resultados al usuario. 


Conceptos básicos de ASP.NET 


Cuando se desarrolló ASP.NET se tuvieron en cuenta una serie de puntos impor- 
tantes para el desarrollador que resumimos a continuación: 


e Separación de la capa de presentación de la lógica de negocio. Esto permitirá 
modificar una capa sin alterar la otra. 


e Acceso a los servicios provistos por .NET Framework. Esto permite que el 
código de la lógica de negocio pueda basarse en el conjunto de clases que de- 
finen ese marco de trabajo. 


e Una página se compila cuando es accedida por primera vez y el resultado de 
la compilación se guarda para ser utilizado en los siguientes accesos a esa pá- 
gina. Esto redunda en una mayor velocidad de ejecución, lo que se traduce en 
un mayor rendimiento. 


e Administración del estado de una aplicación ASP.NET mediante la inclusión 
de diferentes mecanismos para almacenar la información de estado de la mis- 
ma. 


e Programación de la aplicación permitiendo la utilización de diferentes lengua- 
jes, lo que favorece el desarrollo conjunto de distintos grupos de desarrollo. 


e Permitir la actualización de ficheros que conforman la aplicación, aun en el 
caso de que la aplicación se esté ejecutando por múltiples usuarios. 


Resumiendo, una aplicación web con la tecnología mencionada se apoya en el 
hecho de poder interactuar con el NET Framework. El acceso a los servicios del 
sistema se hace a través del CLR (véase el capítulo 1) integrando así la aplicación 
con el sistema operativo. 


El acceso al CLR (máquina virtual de .NET) se proporciona a través de una 
biblioteca de clases tan completa que podemos implementar cualquier cosa reque- 
rida por nuestras aplicaciones. Finalmente, ASP.NET proporciona dos bloques de 
clases muy importantes para el desarrollo de aplicaciones web: formularios web 
(páginas web ASP.NET) y servicios web. Los primeros están estrechamente rela- 
cionados con la capa de presentación, y los segundos, con la lógica de negocio. 
Ambos serán objeto de estudio de forma pormenorizada en este y en los siguientes 
capítulos. 
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a | | Visual 














Páginas web ASP.NET 


Las páginas web ASP.NET proporcionan la interfaz de usuario para las aplicacio- 
nes web a las que nos hemos referido anteriormente. 


Para construir estas páginas, la plataforma ASP.NET incluye objetos y con- 
troles que pueden ser añadidos a la interfaz durante su diseño, y un contexto de 
desarrollo y ejecución para desarrollar y ejecutar aplicaciones en un servidor web. 
El código que se ejecuta en el servidor generará de forma dinámica la salida 
HTML que dará lugar a la página web que será mostrada en un explorador o dis- 
positivo cliente. Estos controles pueden ser de los tipos siguientes: de servidor 
HTML, de servidor web, de validación y de usuario. 


Los controles de servidor HTML están estrechamente relacionados con los 
elementos HTML que procesan; en cambio, los controles de servidor web lo están 
con los controles Visual CH; por lo tanto, proporcionan mayor funcionalidad que 
los controles HTML. La utilización de un tipo u otro de controles dependerá de 
que se prefiera un modelo de objetos parecido a HTML, por ejemplo, porque el 
control vaya a interactuar con la secuencia de órdenes del cliente, o bien se prefie- 
ra un modelo de programación parecido a Visual C#, por ejemplo, porque se 
desee capturar eventos en el contenedor. Lógicamente, los controles de servidor 
web han sido diseñados para proporcionar una forma rápida y sencilla de agregar- 
le funcionalidad a una página web sin tener en cuenta el explorador que utiliza el 
usuario, ya que generan automáticamente HTML correcto para los exploradores. 


Los controles de validación se asocian a los controles de entrada para permitir 
comprobar las entradas del usuario; por ejemplo, obligar a escribir un campo ne- 
cesario, verificar que un valor se encuentra en un intervalo predefinido, etc. 
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Los controles de usuario se crean como formularios web y se incrustan en 
otras páginas web ASP.NET. Se trata de proporcionar una forma sencilla de crear 
menús, barras de herramientas y otros elementos reutilizables. 


Controles HTML 


El primer conjunto de controles de ASP.NET se conoce como controles HTML. 
Dichos controles están definidos en el espacio de nombres System.Web.UL- 
HtmiControls y derivan, directa o indirectamente, de la clase base HtmlControl. 


De forma predeterminada, el servidor no tiene acceso a los elementos HTML 
de una página web ASP.NET, lo cual supone que simplemente sean tratados como 
código de formato que se pasa al explorador. Por ejemplo: 


<input name="Text1" style="width: 284px" type="text"/> 


Sin embargo, si se agrega un atributo id y el atributo runat="server”, 
ASP.NET reconoce los elementos como controles en la página y se pueden pro- 
gramar mediante código basado en el servidor. Por ejemplo, el siguiente código 


HTML crea un objeto HtmlInputText llamado Text]: 


<input id="Text1" style="width: 284px" type="text" runat="server"/> 


Este control, a diferencia del anterior, admitiría código como el de la línea si- 
guiente, que se ejecutaría en el servidor por ser visible en él como un objeto de 
una clase exponiendo los atributos HTML como propiedades: 


string s = Text1l.Value.ToString(); 


La siguiente tabla lista los controles HTML y las etiquetas HTML a los que 








corresponden: 

Control Etiqueta correspondiente 
HtmlAnchor <a> 

HtmlButton <button> 

HtmlSelect <select> 

HtmlTextArea <textarea> 
HtmlInputButton <input type="button"> 


HtmlInputCheckBox <input type="check"> 
HtmlInputRadioButton <input type="radio"> 
HtmlInputText <input type="text"> y <input type="password"> 
HtmlInputHidden <input type="hidden"> 
HtmlInputlimage <input type="image"> 
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HtmlInputFile <input type="file"> 

HtmlForm <form> 

HtmlImage <img> 

HtmlTable <table> 

HtmlTableRow <tr> 

HtmlTableCell <td> 

HtmlGenericControl Cualquier etiqueta sin asignar, 


como <span>, <div>, etc. 





Estos controles son útiles para guardar la compatibilidad con ASP, facilitando 
la transferencia de páginas ASP existentes a páginas ASP.NET. 


Controles de servidor web 


El otro conjunto de controles de servidor de ASP.NET se conoce como controles 
de servidor web. Dichos controles están definidos en el espacio de nombres Sys- 
tem.Web.UI.WebControls y derivan, directa o indirectamente, de la clase base 
WebControl. 


En este grupo se incluyen controles con formato tradicional, como TextBox y 
Button, y controles con un nivel de abstracción mayor como Calendar, 
GridView, ListView o EntityDataSource. Los controles web simplifican los es- 
fuerzos de desarrollo porque: 


e El modelo de objeto, de tipos muy estrictos, implementado por estos compo- 
nentes ayuda a reducir los errores de programación. La clase base WebCon- 
trol implementa las propiedades comunes a todos los controles. 


e Detectan automáticamente las funciones del cliente web (por ejemplo, Micro- 
soft Internet Explorer) y así el usuario puede personalizar su procesamiento 
para aprovechar al máximo dichas funciones. 


e Fn una página web ASP.NET, cualquier propiedad de un control se puede en- 
lazar a datos. Además, existen varios controles web que se pueden usar para 
procesar el contenido de un origen de datos. 


Los controles web aparecen en el formato HTML como etiquetas de espacios 
de nombres; es decir, etiquetas con un prefijo. El prefijo se usa para asignar la eti- 
queta al espacio de nombres del componente durante la ejecución, y el resto de la 
etiqueta es el nombre de la clase. Al igual que los controles HTML, estas etique- 

—” 


tas deben contener un atributo runat="server". A continuación se muestra un 
ejemplo de declaración: 
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<asp:TextBox id="Cajalextol" runat="server" 
Text="xxx"></asp: TextBox> 





En el ejemplo anterior, asp es el prefijo de la etiqueta y hace referencia al es- 
pacio de nombres System.Web.UL.WebControls y TextBox es el nombre de la 
clase. 


El resto de este apartado describe otros controles web de uso bastante común. 
Véase también el ejemplo Cap15|ControlesWeb del CD y el apartado de Ejerci- 
cios resueltos, expuesto al final de este capítulo. 


Presentación del texto 


Label. Permite mostrar texto en una página web ASP.NET mediante programa- 
ción. 


<asp:Label ID="Etiquetal" runat="server" 


| Etiqueta Text="etiqueta"></asp:Label> 


Controles de entrada 


TextBox. Permite a los usuarios escribir datos (texto, números, fechas, etc.) en 
una página web ASP.NET. Es compatible con varios modos, lo que permite que 
se pueda usar para entradas de una línea, de varias líneas y de contraseñas. 

Ñ <asp:TextBox ID="CajaTextol". 
Caja de texto runat="server">Caja de texto 
</asp:TextBox> 

















La propiedad TextMode de un TextBox vale, por omisión, SingleLine (una 
sola línea). Otros valores que puede tomar esta propiedad son MultiLine (múlti- 
ples líneas) y Password (muestra asteriscos). 


CheckBox. Utilizando varias casillas de verificación, se puede proporcionar un 
conjunto de opciones de las que se pueden elegir varias. 












| [Y] Opción 1 runat="server" Text="opción 1" 
l Checked="True" /> 


La propiedad Checked de un CheckBox vale false por omisión. 


Una alternativa a las casillas de verificación es la utilización del control Che- 
ckBoxList que se indica a continuación: 
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<asp:CheckBoxList ID="CheckBoxListl" 
runat="server"> 
| <asp:ListItem Selected="True" 
| Opción 1 Value="1">0pción 1 
| A </asp:ListItem> 
Opción 2 <asp:ListItem 
Value="2">0pción 2 
</asp:ListItem> 
</asp:CheckBoxList><br /> 




















RadioButton. Utilizando varios botones de opción, se puede proporcionar un 
conjunto de opciones que se excluyen mutuamente. 
E <asp:RadioButton ID="Boton0pcion1". | 
runat="server" Text="opción 1" 





9) Opción 1 Checked="True" GroupName="Grupol" /> 
An Aa <br /> 
J Opción 2 <asp:RadioButton ID="RadioButton2" 


runat="server" Text="opción 2" 
GroupName="Grupol" /> 


Obsérvese la propiedad GroupName de los RadioButton; tiene el mismo va- 
lor: Grupol. De esta forma se indica que ambos controles pertenecen al mismo 
grupo; así, cuando se selecciona uno, el que lo estaba deja de estarlo. La propie- 
dad Checked de un RadioButton vale, por omisión, false. 


Una alternativa a los botones de opción es la utilización del control Radio- 
ButtonList que se indica a continuación: 


<asp:RadioButtonList ID="RadioButtonListl 
runat="server"> 
<asp:ListItem 








® Opción 1 Selected="True" Value="1">0pción 1 
e e </asp:Listltem> 
| O Opción 2 <asp:ListItem 


Value="2">0pción 2 
</asp:ListItem> 
</asp:RadioButtonList> 


ListBox. Permite a los usuarios seleccionar uno o más elementos de una lista pre- 
definida. 
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<asp:ListBox ID="ListaFijal" runat="server"> 
| <asp:ListItem | 
| Elemento 1 Selected="True" Value="1">Elemento 1 


| [Elemento 2 </asp:ListItem> 
| <asp:ListItem 
| Value="2">Elemento 2 


</asp:ListItem> 
</asp:ListBox><br /> 





DropDownList. Es igual que ListBox, excepto en que ahora la lista de elementos 
permanece oculta hasta que los usuarios hacen clic en el botón que la despliega. 
Además, este control no admite el modo de selección múltiple. 
—<asp:DropDownList ID="ListaDespl". 
runat="server"> 
<asp:ListItem Value="1">Elemento 1 
Elemento 1 w </asp:Listltem> 
<asp:ListItem Value="2">Elemento 2 
</asp:Listltem> 
</asp:DropDownList> 














Envío y devolución 


Los siguientes controles se utilizan para devolver la página al servidor con valores 
introducidos por el usuario para que estos puedan ser procesados por la lógica de 
la página. Generan un evento Click que se controla en el servidor con el método 
personalizado que implementemos. 


Button. Permite crear un botón de “enviar” o un botón de “órdenes”. 


<asp:Button ID="boton1" runat="server" 
Text="Botón" Width="104px" /> 





Botón 











LinkButton. De manera predeterminada, un control LinkButton es un botón de 
envío, aunque se puede crear también un botón de órdenes (propiedades Com- 
mandName y CommandArgument). 





<asp:LinkButton ID="Enviarl" 
runat="server">Enviar</asp:LinkButton> 





Enviar 


ImageButton. Este control también puede ser empleado para enviar páginas. Se 
procesa como una imagen y puede proporcionar las coordenadas (x, y) del clic del 
usuario. Si lo que se necesita solo es mostrar imágenes en la página web, puede 
utilizarse también el control Image. 
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| <asp:ImageButton ID="btImagen1" 
| fjceballos runat="server" ImageUrl="miLogo.png" 


Height="48px" Width="88px" /> 
Exploración 
HyperLink. Permite crear vínculos en una página web para que los usuarios pue- 


dan moverse por las páginas de una aplicación. La ventaja de estos controles es 
que permiten establecer las propiedades de los vínculos en el servidor. 





i <asp:HyperLink ID="Enlacel" runat="server" 
Enlace NavigateUrl="MiPagina.aspx">Enlace 
</asp:HyperLink> 


Controles de diseño 


Panel. Este control se suele utilizar como contenedor de otros controles creados 
dinámicamente (normalmente no tiene ninguna apariencia visual). 


Table. Este control, junto con los controles asociados TableRow y TableCell, 
permite crear tablas y diseños tabulares. 

E <asp:Table ID="Tablal" runat="server"... 
Gridlines="Both"> 
<asp:TableRow runat="server"> 

<asp:TableCell runat="server">[0,0]1</asp:TableCel1> 


[o.oo 1] <asp:TableCell runat="server"> [0,1]</asp:TableCell> 
- </asp: TableRow> 
[1.01/81,1] <asp:TableRow runat="server"> 


<asp:TableCell runat="server">[1,0]</asp:TableCel1> 
<asp:TableCell runat="server">[1,11</asp:TableCel1> 
</asp:TableRow> 
</asp:Table> 














Selección de fechas 


Calendar. Se utiliza para poder explorar fechas y hacer selecciones de fechas, in- 
cluyendo rangos de fechas. 
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<asp:Calendar ID="Calendarl" 
=< runat="server" 
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</asp:Calendar> 
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Controles con enlaces a datos 


Los 


controles con enlaces a datos, como por ejemplo GridView, DetailsView, 


FormView, ListView, DataList y Repeater sirven para procesar el contenido de 
un origen de datos. Los veremos con más detalle en el siguiente capítulo. 


Controles de validación 


Los 


controles de validación simplifican la tarea de validar las entradas del usuario. 


Generan automáticamente un script para el cliente para que los exploradores de 
nivel superior ejecuten validaciones en la máquina del usuario antes de una devo- 
lución, originando páginas de mayor interactividad y facilidad. Al mismo tiempo, 
funcionan de forma idéntica en el servidor como mecanismo de arranque tras un 


erro 


r. A continuación se indica cuáles son estos controles: 


RequiredField Validator. Sirve para garantizar que el usuario rellena los con- 
troles de entrada de datos que requieren una entrada. 


RangeValidator. Se emplea para comprobar que la entrada del usuario está 
dentro del rango válido de valores. Esta opción es útil en las entradas numéri- 
cas o de fechas. 


CompareValidator. Sirve para comprobar la entrada en un control respecto a 
la de otro. 


RegularExpression Validator. Permite comprobar la entrada de datos del 
usuario. Para ello emplea como criterio una expresión regular (o un modelo de 
cadenas). 


CustomValidator. Permite proporcionar una lógica personalizada de valida- 
ción de cliente y de servidor. 


ValidationSummary. Proporciona un resumen de los mensajes de error pro- 
ducidos por todos los controles de validación. 


La propiedad CausesValidation del control que origina la petición al servidor 


tiene que valer true. 
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Un ejemplo de diseño de una página web ASP.NET 


Aplicando la teoría expuesta hasta ahora, vamos a diseñar una página web 
ASP.NET, como la que muestra la figura siguiente, que permita a un alumno con- 
certar una tutoría con su profesor. 





f e |(8 ” 


[8 http://localhost:3303/Default.aspx O ~ BG | (2 localhost 


CONCERTAR UNA TUTORÍA 





Alumno: 











Con el profesor: 














Fco. Javier Ceballos Sierra v 
Día: 
lunes v 


Hora: 100 120 160 180 


Asunto: 

















Enviar datos Restablecer 





























A e 





El código HTML extendido (XHTML) que da lugar a esta página web 
ASP.NET puede ser el indicado a continuación y puede obtenerlo del fichero 
Capl5lTutorias|Default.aspx del CD. En los siguientes apartados verá como el 
entorno de desarrollo generará este código automáticamente por el simple hecho 
de arrastrar los controles de servidor web sobre la superficie de diseño (la expre- 
sión «nbsp o &#160 indica un espacio en blanco). 


<html> 
<head runat="server"> 
<title>Concertar una tutoría</title> 
</head> 
<body style="text-align: center"> 
<form id="formTutorias" runat="server"> 
<strong><span style="font-family: Arial; font-size: 24pt"> 
CONCERTAR UNA TUTORÍA</span></strong><br /> 
<br/> 
<div style="text-align: left; font-family: Arial"> 
Alumno:<br/> 
<asp:TextBox ID="ctAlumno" runat="server" Width="504px"> 
</asp:TextBox><br/> 
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<br/> 
Con el profesor:<br/> 
<asp:DropDownList ID="IsProfesor" runat="server" 
Width="296px" Font-Size="Medium"> 
<asp:ListItem Value="1"> 
Fco. Javier Ceballos Sierra</asp:Listltem> 
<asp:ListItem Value="2"> 
Inmaculada Rodríguez Santiago</asp:Listltem> 
<asp:ListItem Value="3"> 
Concha Batanero Ochaita</asp:Listltem> 
<asp:ListItem Value="4"> 
M. Dolores Rodríguez Moreno</asp:Listltem> 
<asp:ListItem Value="5"> 
Martín Knoblauch Revuelta</asp:Listltem> 
</asp:DropDownList><br/> 
<br/> 


Día 


¿<br/> 


<asp:DropDownList 


Font-Size="Medium”> 
































D="IsDia" runat="server" 








<asp:ListItem Value="1">lunes</asp:Listltem> 
<asp:ListItem Value="2">martes</asp:Listltem> 
<asp:ListItem Value="3">miércoles</asp:Listltem> 
<asp:ListItem Value="4">jueves</asp:Listltem> 
<asp:ListItem Value="5">viernes</asp:Listltem> 

</asp:DropDownList><br /> 

<br /> 

Hora: 4nbsp; 

<asp:RadioButtonList ID="btopHora" runat="server" 

TextAlign="Left" RepeatDirection="Horizontal" 

RepeatLayout="Flow"> 
<asp:ListItem Selected="True">10</asp:Listltem> 
<asp:ListItem>&nbsp;&nbsp;&nbsp;12</asp:ListItem> 
<asp:ListItem>&nbsp;&nbsp;&nbsp;16</asp:ListItem> 
<asp:ListItem>&nbsp;&nbsp;&nbsp;18</asp:ListItem> 

</asp:RadioButtonList><br /> 

<br /> 

Asunto:<br /> 

<asp:TextBox ID="ctAsunto" runat="server" Height="64px" 

TextMode="MultiLine" Width="440px"></asp:TextBox><br /> 

<br /> 

<asp:Button ID="btEnviar" runat="server" 

Text="Enviar datos" Width="112px" /> 

&nbsp; 

<asp:Button ID="btRestablecer" runat="server" 

Text="Restablecer" Width="112px" /></div> 

</form> 
</body> 


</html> 
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Software para el desarrollo de aplicaciones ASP.NET 


Para generar aplicaciones ASP.NET instale en primer lugar el servidor de aplica- 
ciones Internet Information Server (IIS) y después el entorno de desarrollo inte- 
grado (EDI) Visual Studio, o bien descargue la versión gratuita de Microsoft 
Visual Studio Express para Web. Si no instala IIS podrá utilizar el servidor de 
desarrollo de ASP.NET incorporado con el EDI, suficiente para ver los resultados 
de una aplicación y ponerla a punto, o también JIS Express. No obstante, es im- 
portante realizar las pruebas definitivas de acceso a la aplicación y de seguridad 
en un servidor web como IIS, de ahí que si quiere realizar estas pruebas en su má- 
quina, tenga que instalar IIS en la misma. 


Si ya tiene instalado el EDI, crear la página anterior con este EDI es muy sen- 
cillo. Cree un nuevo proyecto sitio web (Archivo > Nuevo > Sitio web) seleccione 
Visual CH y la plantilla Sitio web vacío de ASP.NET. Inicialmente, puede ubicarlo 
en su sistema de archivos y haga clic en Aceptar. 


En Visual Studio se pueden crear proyectos de aplicación web (Archivo > 
Nuevo > Proyecto > VC# > Web) o proyectos de sitio web. Cada tipo de proyecto 
tiene ventajas y desventajas (emplear un fichero de proyecto o no, compilar el có- 
digo fuente explícitamente o compilarlo de forma dinámica en el servidor la pri- 
mera vez que se recibe una solicitud, instalar un ensamblado en el servidor de 
producción o copiar los ficheros de código fuente en el servidor, migración o no, 
etc.). El siguiente ejemplo utiliza la plantilla sitio web. Sin embargo, usted es libre 
de utilizar la plantilla aplicación web si, después de un análisis, cree que le favo- 
rece. Independientemente de la plantilla elegida, el código que hay que escribir 
para cada una de las páginas web es el mismo. 


Nuevo sitio web 





b Reciente .NET Framework 4.5 ~ Ordenar por: Predeterminado 
4 Instalado 54 O 
Sitio web vacío de ASP.NET Visual C# Tipo: Visual C# 


4 Plantillas Sitio web vacío 
Visual Basic Sitio de ASP.NET Web Forms Visual C# 


Visual CF 


Ejemplos Sitio web ASP.NET (Razor v1) Visual C# 


D En línea o Sitio web de ASP.NET (Razor... Visual C# 
Sitio web de entidades de dat...Visual C# 
Servicio WCF Visual C# 


Sitio web de informes ASP.NET Visual C# 


Ubicación web: Sistema de archivos Y] C#-4Ed\Ejemplos\Projects\Cap15\Tutorias ~ Examinar... | 


Sistema de archivos A ===, 
me È C r 


FTP 
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Si hubiéramos elegido como ubicación web HTTP, la carpeta del proyecto se- 
ría ubicada en el servidor IIS, concretamente en la carpeta C:linetpublwwwroot. 


Ya tenemos un proyecto vacío, sin páginas web. Vamos a añadir una página 


web; será nuestra superficie de diseño. Para ello, haga clic sobre el nombre del 
proyecto utilizando el botón secundario del ratón y seleccione en el menú contex- 
tual que se muestra, la orden Agregar > Formularios Web Forms; seleccione el 
nombre de la página o acepte el predefinido y haga clic en Aceptar. Después de 
esta operación ya disponemos de una página web; en nuestro caso de De- 
fault.aspx. A continuación, arrastre los controles sobre la superficie de diseño, se- 
gún muestra la figura siguiente, y el generador de código hará el resto por usted. 






























































DA] Tutorias(1) - Microsoft Visual Studio Inicio rápido (Ctrl+Q) Po 0 x 
ARCHIVO EDITAR VER SMIOWEB COMPILAR DEPURAR EQUIPO SQL FORMATO HERRAMIENTAS VMWARE PRUEBA 
ARQUITECTURA VS ANYWHERE ANALIZAR VENTANA AYUDA 
O- B- am y P Internet Explorer ~ Debug ~ AM- S 
E O Bs 
S Defaultaspx * X Defaultaspxes ~ Explorador de soluciones Xx 
a = Az 
S > a o-a aw] o sm 
o 
7 CONCERTAR UNA TUTORIA ars EE cin A 
1 E 
5 [div] E] Solución Tutorias(1)' (1 proyecto) 
E Alumno: 4 8 Tutorias(1) 
E| 4 ¿3 Defaultaspx 
“bh Default.aspx.cs 
Con el profesor: l D Web.config 
|Fco. Javier Ceballos Sierra * 
Día: n 
lunes bd 
r Explorador d... Vista de clases Explorador d... 
Hora: 106 120 16° 180 Propiedades Y Ax 
<DIV> 
Asunto: E = [5] 4 
(id) a 
>] accesskey 
X 
aria-activedescenda 
aria-atomic False 
Enviar datos | Restablecer | aria-autocomplete none 
4 > aria-busy False 
[a Diseño | Dividir | © Código | [A|[<htmi> |[<body> |[<form#tormTutorias>| <div> p|  aria-checked undefined 
aria-controls 
Resultados 1x aria-describedby 
Mostrar resultados desde: Compilar hd € a aria-disabled False 
========== Compilar: 1 correctos o actualizados, @ incorrectos, @ omitidos aria-dropeffect none 
aria-expanded undefined 


Operaciones de h... Lista de errores Jerarquía de llam... Resultados Resultados de la... Resultados de la... 


aris-finutn 





Compilación correcta 


Visual Studio incluye para el diseño de los controles de servidor de ASP.NET 


una lista de tareas: 


<asp:DropDownList ID="1sProfesor” runat="server" 
Width="296px" Font-Size="Medium”> 


</asp:DropDownList><br/> 
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y también permite conectar fácilmente manejadores de eventos a dichos controles, 
bien desde la vista de diseño o bien desde la vista de código: 


<asp:DropDownList ID="1sProfesor” runat="server” 
Width="296px" Font-Size="Medium" 


Onp 
$ OnCallingDataMethods = 
</asp:DropDownList : 
% OnCreatingModelDataSource 
</form> 
</body> % OnDataBinding 
</html> 5 a 


OnDisposed 


Evidentemente, puede utilizar la página de propiedades para personalizar las 
propiedades de cada uno de los controles de la página, igual que lo hacíamos en 
Windows Forms. 


Una vez terminado el diseño, si hace clic en el botón Código que hay debajo 
del diseñador, podrá ver el código HTML generado. Si ahora ejecuta la aplica- 
ción, el servidor de desarrollo de ASP.NET le mostrará la página web en el explo- 
rador/navegador. Observe en la barra de direcciones de su navegador la URL 
(dirección de Internet) utilizada para acceder a la aplicación y ejecutarla: 


http: //localhost:3303/ControlesWeb/Default.aspx 


Cuando la aplicación esté instalada en un servidor, cosa que veremos a conti- 
nuación, el usuario que quiera acceder a la misma deberá proceder desde su nave- 
gador de forma análoga: 


http: //nombre_servidor|IP_servidor/ControlesWeb/Default.aspx 


Cuando el servidor esté instalado en nuestra propia máquina de desarrollo, el 
nombre del servidor que tiene que utilizar es localhost o, en su lugar, la dirección 
IP 127.0.0.1. El puerto HTTP, por omisión, es el 80 (localhost:80). 


Componentes de una página web ASP.NET 


En una página web ASP.NET, la programación de la interfaz de usuario se divide 
en dos partes: la componente visual y la lógica. En el ejercicio anterior solo se ha 
expuesto la visual, fichero Default.aspx, que como hemos visto está compuesta 
por un fichero que contiene HTML extendido para dar cabida a los controles de 
servidor ASP.NET. Por ejemplo, observe las siguientes líneas: 


<%@ Page Language="C¿F" AutoEventWireup="true" 
CodeFile="Default.aspx.cs" Inherits="_Default" %> 
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<!DOCTYPE html> 


<html xmlns="http://www.w3.org/1999/xhtml"> 
<head runat="server"> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 
<title></title> 
</head> 
<body style="text-align: center"> 
<form id="formlutorias" runat="server"> 





<asp:DropDownList ID="1sProfesor" runat="server" 
Width="296px" Font-Size="Medium"> 


</asp:DropDownList> 
</form> 
</body> 
</html> 


Observará que cada página web incluye etiquetas estándar HTML, tales como 
<html>, <head> o <body> que definen las secciones básicas de una página web, 
y además otras etiquetas y atributos (se han resaltado en negrita) no estándar co- 
mo <asp:DropDownList>: esta etiqueta define un control de servidor ASP.NET, 
concretamente una lista desplegable. Obviamente, este código específico de 
ASP.NET no significa nada para un navegador web, ya que no es HTML válido. 
Esto no es un problema, ya que el navegador web nunca va a procesar este códi- 
go. En su lugar, cuando la página sea solicitada/reenviada al servidor, el motor de 
ASP.NET crea una página HTML de la página ASP.NET una vez procesada en el 
servidor. En este punto, etiquetas tales como <asp:DropDownList> serán susti- 
tuidas con las etiquetas HTML que tienen la misma apariencia; la página obtenida 
después de este proceso es la que se envía al navegador. 


La lógica de las páginas web ASP.NET estará compuesta por el código que 
escribamos para interactuar con cada página. Este código puede residir en un 
script en la propia página HTML o en una clase independiente, caso de nuestra 
aplicación: fichero Default.aspx.cs; en este caso, al fichero que contiene ese códi- 
go se le conoce como fichero de código subyacente y es la forma más habitual de 
crear una página web ASP.NET, ya que separa la presentación de la página de su 
lógica de negocio. En nuestro ejemplo, el contenido de dicho fichero es: 


public partial class _Default : System.Web.UlI.Page 

( 
protected void Page_lLoad(object sender, EventArgs e) 
( 


) 
) 
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Por el momento, no vamos a escribir ninguna lógica de negocio para la página 
de nuestro ejemplo, lo dejamos para un poco más adelante. 


Una vez finalizada nuestra aplicación web podemos publicarla en un servidor 
de Internet. Veamos a continuación cómo se realiza este proceso. 


¿Cómo se publica una aplicación web? 


Publicar una aplicación web, o simplemente páginas web, significa ponerlas en un 
servidor de Internet a disposición de los usuarios de Internet. Para ello, la máquina 
que va a trabajar como servidor debe proporcionar un sitio web. ¿Cómo se crea un 
sitio web? Cuando se instala IIS en Windows se configura un sitio web de manera 
predeterminada. Este sitio se localiza en C:WMnetpublwwwroo!t. 


Entonces, para publicar una aplicación web, páginas web en general, simple- 
mente hay que moverla al directorio lnetpublwwwroot. Por ejemplo, si nosotros 
movemos los documentos Default.aspx y Default.aspx.cs a este directorio en un 
servidor denominado www.miservidor.com, cualquier usuario podría acceder a la 
misma escribiendo en su navegador la siguiente URL: 


http: //www.miservidor.com/Default.aspx 


Pero, evidentemente, en ese servidor habrá más de una aplicación instalada; 
por eso, lo normal es que cada aplicación esté contenida en su propio directorio, 
por ejemplo en lnetpublwwwrootlapweb01. Ahora, la URL de acceso sería así: 


http: //www.miservidor.com/apweb01/Default.aspx 


Pero IIS requiere que este directorio sea un directorio virtual vinculado con el 
directorio físico de su sistema de ficheros que contiene la aplicación web. Esto es, 
un directorio virtual se utiliza para incluir en IIS el contenido de la aplicación web 
sin tener que mover o copiar los ficheros desde el directorio físico de la aplicación 
al directorio raíz del servidor web. No obstante, es bastante habitual que ese direc- 
torio físico sea un subdirectorio de l/netpublwwwroot con el mismo nombre que el 
directorio virtual, quedando ambos, físico y virtual, solapados. 


Como ejemplo vamos a publicar la aplicación que guardamos en el directorio 
Tutorias. Como ya hemos indicado, lo habitual es que cada aplicación web tenga 
su propio directorio; por lo tanto, cree un subdirectorio, por ejemplo ApTutorias, 
del directorio C:lnetpublwwwroot del sitio web, y, después, copie en él el conte- 
nido del directorio donde guardó su aplicación, según muestra la figura siguiente: 
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4 iy OS (C:;) 
JÌ Archivos de programa 
J Archivos de programa (x86) 
4 |. inetpub 
AdminScripts 
custerr 
ftproot 
history 
logs 


temp 


Fe FF FF FP 


wwwroot 
+. ApTutorias «== 


JÌ aspnet_client 


Default.aspx, 
Default.aspx.cs,... 


El paso siguiente es crear un directorio virtual que haga referencia a este di- 
rectorio físico, proceso que se hace con las herramientas administrativas de IIS. Si 
al directorio virtual le damos el mismo nombre que al físico, algo bastante habi- 
tual, en el sistema de ficheros solo veremos un directorio: el virtual. 


Crear un directorio virtual 


La utilización de directorios virtuales permite publicar contenido web que no se 
encuentra en la carpeta raíz o principal del servidor web; por ejemplo, contenido 
que esté en un directorio cualquiera del sistema de ficheros del equipo local o de 
un equipo remoto. También es un método práctico porque no requiere un sitio 
web único para cada aplicación (esta sería otra alternativa). 


Crear un directorio virtual que haga referencia a un directorio físico donde es- 
tá almacenada una aplicación web, controlar el contenido de su sitio web o FTP, o 
controlar el acceso a estos sitios, requiere de operaciones de administración del 
servidor. Para ello, IIS proporciona el complemento Internet Information Services 
(US): un servidor web y un conjunto de servicios para Microsoft Windows. 


Por ejemplo, si usted es un programador que quiere probar un sitio antes de 
cargarlo en una intranet corporativa o en Internet, podrá utilizar esta herramienta 
para probar la configuración y ver exactamente cómo quedará en el servidor final. 
Los servicios de IIS incluyen las características siguientes: 


e Opciones de servidor adicionales, como las opciones para administrar un sitio 
FTP, aislar aplicaciones, asignar tipos MIME o designar motores de secuen- 
cias de comandos adicionales. 

e Un asistente para crear directorios virtuales nuevos o para convertir una apli- 
cación en una aplicación ASP.NET. 
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e La capacidad de administrar instalaciones de los servicios de IIS a través de la 
red. 


Y, ¿cómo accedemos a los servicios de IIS? Dependiendo de la versión de su 
sistema operativo, visualice el menú de inicio y haga clic con el botón secundario 
en Equipo o Mi PC y seleccione Administrar > Servicios y Aplicaciones > Admi- 
nistrador de IIS. 


Llegado a este punto, para crear un directorio virtual, seleccione el sitio web o 
FTP al que desee agregar un directorio virtual. Haga clic con el botón secundario 
del ratón en el icono correspondiente al sitio (en la figura Default Web Site) y se- 
leccione Agregar directorio virtual. En el siguiente apartado aprenderá que esta 
operación está implícita cuando se convierte una aplicación ubicada en un directo- 
rio del sitio web en una aplicación web utilizando los servicios de IIS. 
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Después, complete esta tarea especificando el nombre del directorio virtual 
(equivale al Alias de la aplicación) y la ruta física del directorio de la aplicación. 
Para nuestro ejemplo escribiremos como alias de la ruta de acceso física C: Wnet- 
publwwwrootlApTutorias, ApTutorias. 
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Agregar directorio virtual [ENS] 





Nombre del sitio: Default Web Site 


Ruta de acceso: /ApTutorias 


Alias: 

ApTutorias 

Ejemplo: images 

Ruta de acceso fisica: 

CiinetpublwwwrootApTutorias aia | 


Autenticación de paso a través 








Conectar como... | Probar configuración... 





{ Aceptar | Cancelar | 























Para eliminar un directorio virtual seleccione, en el complemento IIS, el di- 
rectorio virtual que desee quitar, haga clic con el botón secundario del ratón en él 
y, a continuación, seleccione Eliminar o Quitar. Al quitar un directorio virtual no 
se elimina el directorio físico correspondiente. 


Pero crear un directorio virtual no sería suficiente si necesitamos establecer 
una sección de configuración en la aplicación a través de un fichero de configura- 
ción. Tendríamos que convertir la aplicación en una aplicación web de IIS, que es 
lo que normalmente siempre se hace, y lo que hace el EDI de forma automática si 
especificamos como ubicación ATTP en lugar de Sistema de archivos. 


Convertir la aplicación en una aplicación web de IIS 


Para convertir una aplicación en una aplicación web de IIS, además de pertenecer 
a un sitio web, tendríamos que asignarla a un grupo de aplicaciones. Para ello, si- 
ga alguna de las formas siguientes: 


e Siel directorio de la aplicación no es un directorio del sitio web, haga clic con 
el botón secundario del ratón en el icono correspondiente al sitio (en la figura 
Default Web Site) y seleccione Agregar aplicación. 


e Si el directorio de la aplicación es un directorio del sitio web (por ejemplo el 
directorio ApTutorias), o es un directorio virtual de la aplicación, haga clic 
con el botón secundario del ratón sobre este directorio y ejecute la orden Con- 
vertir en aplicación del menú contextual que se muestra. 


En todos los casos, si el directorio virtual no existe, se crea y la aplicación se 
convierte en una aplicación para IIS, lo que conlleva designar un directorio como 
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raíz, o punto inicial, de la aplicación y especificar propiedades concretas para di- 
cha aplicación como, por ejemplo, el grupo de aplicaciones al que pertenecerá. 


r 
Agregar aplicación 0 E” 








Nombre del sitio: Default Web Site 


Ruta de acceso: f 


Alias: Grupo de aplicaciones: 


ApTutorias DefaultAppPool Seleccionar... 


Ejemplo: ventas 


Ruta de acceso física: 


CiinetpubiwwwrootApTutorias 


Autenticación de paso a través 





Conectar como... | | Probar configuración... | 























Un grupo de aplicaciones aísla a la aplicación de las aplicaciones de otros 
grupos en el servidor, reduciendo así la posibilidad de que una aplicación obtenga 
acceso a los recursos de otra aplicación, evitando que las aplicaciones en otros 
grupos se vean afectadas cuando una aplicación de un grupo genera un error, y 
mejorando el rendimiento del servidor y de las aplicaciones al poder distribuir los 
recursos según las necesidades de cada grupo. Cada grupo de aplicaciones queda 
definido por las siguientes características: nombre del grupo de aplicaciones, es- 
tado (si se inicia o no un grupo), versión de .NET Framework, modo de canaliza- 
ción administrada (modo de procesamiento de solicitudes: integrada o clásica), 
identidad (servicio de red, servicio local, sistema local o una identidad personali- 
zada) y número de aplicaciones que contiene un grupo. 
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e 
Æ Administración de equipos 





Archivo Acción Ver Ayuda 


| 25 8 


] 
EJ Amistad 60 | E) » FICEBALLOS-PC >» Grupos de aplicaciones 
a Ü} Herramie | == 
@ Progr| Conexiones 
B EDT | A 
E Carpe||5 FICEBALLOS-PC (fcd | Esta página permite ver y administrar la lista de grupos de aplicaciones del servidor. Los grupos 
ES Usuan] E) Grupos de aplicad | de aplicaciones están asociados a procesos de trabajo, contienen una o más aplicaciones, y 
5) Rendi| a- Sitio proporcionan aislamiento entre aplicaciones, 


El Admil| “ 





93 Grupos de aplicaciones 





a: Ir ~ G Mostrar todo | Agrupar por: 














2 Almacen ($ ApTutorias! n z 
5) Admil E aspnet_die Nombre Estado Versión... Modo de canalización... Identidad 
a EA Servicios Ê ASP.NET v4.0 Iniciado v4.0 Integrada NetworkService 
W} Admi E) ASP.NET v4.0 Classic Iniciado v4.0 Clásica ApplicationPoolldent 
4 Servici Ê Classic .NET AppPool Iniciado v4.0 Clásica ApplicationPoolldent 
E] Contr| E) DefaultAppPool Iniciado v4.0 Integrada NetworkService 
m Aci ms Ea 4 dba 7 


Por ejemplo, si una aplicación utiliza un servicio de SQL Server que se ha 
iniciado bajo la identidad Servicio de red (NetworkService), dicha aplicación debe 
pertenecer a un grupo con esta identidad. 


Las aplicaciones web de IIS versión 7 o superior se pueden configurar para 
utilizar el modo clásico o el modo integrado. El modo clásico mantiene la compa- 
tibilidad con versiones anteriores de IIS, opción que por lo general requiere pocas 
o ninguna modificación en las aplicaciones existentes. 


Una vez finalizado todo este proceso de configuración, para ver la página pu- 
blicada simplemente tiene que escribir en el navegador la URL adecuada: 


http://localhost/ApTutorias/Default.aspx 


O bien, escriba simplemente: 


http://localhost/ApTutorias 


¿Por qué? Porque default.aspx (no se hace distinción entre minúsculas y ma- 
yúsculas), igual que otros como index.html, está establecido como documento 
predeterminado. Los documentos predeterminados se establecen a través de la op- 
ción Documento predeterminado de los servicios de IIS. 


Seguridad asociada con una carpeta 


En ocasiones tendremos también que verificar si el usuario bajo cuya identidad se 
ejecuta la aplicación tiene acceso a la carpeta de la misma o a alguna subcarpeta 
de esta y qué permisos tiene para operar sobre esa carpeta. Por ejemplo, puede su- 
ceder que iniciemos una aplicación web que permite almacenar imágenes en una 
determinada carpeta del sitio web y que al almacenar una imagen en la misma se 
produzca un error porque el usuario bajo cuya identidad se ejecuta la aplicación 
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no existe (habría que añadirlo) o, si existe, no tiene permisos para escribir en la 
carpeta. En ambos casos, para conceder acceso a una carpeta o a un archivo, edite 
desde el explorador de Windows los permisos de la carpeta. Para ello, haga clic 
con el botón secundario del ratón en la carpeta o en el archivo, elija Propiedades 
y seleccione la ficha Seguridad. Si el usuario no existe, haga clic en Editar > 
Agregar (después en Opciones avanzadas > Buscar ahora) para agregarlo. Si 
existe (o una vez añadido), selecciónelo y active los permisos según el acceso 
deseado (por ejemplo, escritura). También puede realizar este proceso desde el 
administrador de IIS, seleccionando la carpeta de la que se quieren modificar los 
permisos y ejecutando la acción Editar permisos: 


E 
JL Permisos de SitioWeb = 


Seguridad | 








Nombre de objeto: C:\inetpub\wwwroot\SitioWeb 


Nombres de grupos o usuarios 
$2 CREATOR OWNER 
42, Servicio de red 
$2 SYSTEM 
a Administradores ficeballos-PC' Administradores) 
2 Usuarios ficeballos-PCUsuarios) X 


«| nr + 





» 


Lom 

















| Agregar... | | Quitar 

Permisos de Servicio de red Permitir Denegar 
Lectura y ejecución [Y] a fe 
Mostrar el contenido de la carpeta [Y] [5 E 
Lectura [Y] | |3 
Escritura on 2 














Permisos especiales 








Obtener más información acerca de control y permisos de acceso 

















Aceptar l Cancelar || Aplicar | 














Modelo de ejecución de una página web ASP.NET 


Para acceder a una página web basta con proporcionar su dirección al navegador o 
cliente web. Si es la primera vez que se accede a esta página, un analizador sintác- 
tico evalúa, entre otras cosas, con qué lenguaje se ha escrito el código y la envía al 
compilador correspondiente al lenguaje. Recuerde que .NET Framework incluye 
por sí mismo los compiladores C# y Visual Basic, pudiendo realizar así la tarea de 
compilación sin necesidad de que esté instalado el entorno de desarrollo Visual 
Studio en su totalidad. 


El compilador genera el ensamblado correspondiente en código intermedio 
(IL) y lo almacena en la caché de ensamblados. 
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Para ejecutar el ensamblado, este es pasado al módulo de ejecución HTTP- 
Runtime perteneciente al CLR, que lo traduce a código nativo y lo ejecuta. El re- 
sultado de la ejecución, código HTML, será devuelto al cliente web. 


La siguiente vez que esta página sea invocada, ya se encontrará en memoria, 
por lo que su ejecución será directa. 


Analizador 
sintáctico 


Cliente web Compilador 


Memoria Caché de 
HTTPRuntime s ensamblados 





Cliente Servidor 


Puede suceder que la página se modifique entre un acceso y el siguiente. En 
este caso, se vuelve a realizar el proceso completo. 


También puede ocurrir que la página no sea accedida durante un tiempo pro- 
longado, en cuyo caso puede suceder que su código binario no esté ya en memo- 
ria, pero cabe la posibilidad de que sí esté el ensamblado en la caché de 
ensamblados, en cuyo caso volverá a ser compilado a código binario y ejecutado. 


Finalmente, es posible configurar una página completa o parte de ella, sim- 
plemente porque no varía, por ejemplo, para que permanezca en la caché de sali- 
da. En este caso, cuando se trate de una página completa y sea solicitada, será 
tomada directamente de este lugar sin necesidad de realizar ninguno de los pasos 
mencionados anteriormente. Cuando solo sea parte de ella la que se mantiene en 
la caché de salida, se procesa el resto de la página y se inserta esta parte al produ- 
cir el HTML que se enviará al cliente web. 
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Lógica de negocio 


Para dar un poco más de realismo a nuestra aplicación ejemplo, vamos a imple- 
mentar la capa de acceso a datos y la lógica de negocio que proporcione los nom- 
bres de los profesores a la capa de presentación. 


S1 recuerda, en el capítulo LINO expusimos cómo crear la capa de acceso a 
datos utilizando Code First. Podemos utilizar esta forma de crear el modelo de en- 
tidades para crear una entidad profesor. Para ello, siguiendo lo explicado en ese 
capítulo, empezaremos por instalar EF en la aplicación. 


Una vez instalado EF, vamos a crear las clases de entidad que definirán el 
modelo de entidades. Para este ejemplo solo vamos a definir una clase de entidad: 
profesor. Para guardar esta clase, vamos a añadir una carpeta al proyecto denomi- 
nada App_Code: el código fuente almacenado en esta carpeta se compilará auto- 
máticamente durante la ejecución. Después añadiremos a esta carpeta la clase que 
se muestra a continuación: 


[Table("profesores")] 

public class profesor 

( 
[Key] 
public int id_profesor { get; set; ) 
public string nombre { get; set; ) 


} 


Una vez definido el modelo de entidades, lo siguiente es crear el contexto de 
objetos que, como sabemos, provee la funcionalidad para consultar y trabajar con 
las entidades como objetos. En este ejemplo, este contexto va a estar definido por 
la clase Contexto Tutorias derivada de DbContext de EF: 


using System.Data.Entity; 


public class ContextoTutorias : DbContext 
( 

public DbSet<profesor> profesores [ get; set; ) 
) 


El siguiente paso es generar la base de datos e iniciarla con una serie de datos 
de ejemplo. Para ello, vamos a añadir a la carpeta App_Code del proyecto una 
nueva clase /niciarBaseDeDatos derivada de DropCreateDatabaselfModel- 
Changes que redefina el método Seed: 


public class IniciarBaseDeDatos 
DropCreateDatabaselfModelChanges<ContextoTutorias> 
( 
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protected override void Seed(ContextoTutorias contexto) 


( 
ObtenerProfesores().ForEach(prof => contexto.profesores.Add(prof)); 


) 


private static List<profesor> ObtenerProfesores() 
( 
1/ 
) 
) 


El aspecto del método ObtenerProfesores es el siguiente: 


private static List<profesor> ObtenerProfesores() 


( 
var profs = new List<profesor> 


( 


new profesor 
( 

id_profesor = 1, 

nombre = "Fco. Javier Ceballos Sierra" 
e; 


1! 


E 
return profs; 


} 


El siguiente paso será establecer la estrategia de iniciación que hemos imple- 
mentado, para lo cual habrá que invocar al método SetInitializer<7Context> de la 
clase System.Data.Entity.Database. Esto lo haremos desde el controlador del 
evento Load de la página: 


private void Forml_Load(object sender, EventArgs e) 
( 
using (var bd = new ContextolTutorias()) 
( 
Database.SetInitializer<Contextolutorias>(new IniciarBaseDeDatos()); 
1! 


Ahora, la base de datos se creará de forma automática la primera vez que se 
utilice el contexto. Según expusimos en el capítulo LINO, EF Code First presupo- 
ne una cadena de conexión basada en SOL Server Express y un nombre para la 
base de datos, datos que asumimos para este ejemplo. 
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Asegúrese de que el atributo AutoEventWireup de la directriz Page de la 
página vale true para que se ejecute el controlador Form1_Load: 


<%@ Page Language="C¿f" AutoEventWireup="true"... 


Cuando AutoEventWireup vale true, ASP.NET establece los controladores 
de los eventos de página, como Load o Init, implícitamente. En este caso, los mé- 
todos que respondan a estos eventos deben seguir la siguiente convención para 
formar su nombre: Page evento; por ejemplo, Page Load o Page Init. Se reco- 
mienda no utilizar este mecanismo si el rendimiento es una consideración clave. 


Nuestro objetivo es que el control DropDownList /sProfesor muestre la lista 
de profesores de la tabla profesores de la base de datos que hemos construido. Lo 
primero entonces es modificar el diseño para que la lista IsProfesor aparezca ini- 
cialmente vacía: 


<asp:DropDownList ID="IsProfesor" runat="server" 
Width="296px" Font-Size="Medium"> 
</asp:DropDownList> 


Un control DropDownList es una lista desplegable de selección única. Para 
controlar su apariencia proporciona las propiedades BorderColor, BorderStyle y 
BorderWidth y para especificar los elementos que deben aparecer en el control, 
basta con añadir objetos ListItem por cada entrada, según hicimos anteriormente 
para /sProfesor, o bien enlazar el control con un origen de datos a través de su 
propiedad DataSource o DataSourcelD. Finalmente, es necesario invocar al mé- 
todo Control.DataBind para enlazar el control con el origen de datos. Algunas de 
las propiedades y métodos de interés relacionados con el origen de los datos son 
las siguientes: 


e DataMember. Hace referencia al nombre de la lista de datos a la que se enla- 
zará el control en los casos en que dicho origen contenga más de una lista dis- 
tinta de elementos de datos. 


e DataSource. Hace referencia al objeto del cual el control enlazado a datos re- 
cupera su lista de elementos de datos. 


e DataSourcelD. Hace referencia al identificador del control del cual el control 
enlazado a datos recupera su lista de elementos de datos. 


e DataSourceObject. Obtiene un objeto que implementa la interfaz IData- 
Source que proporciona acceso al contenido de datos del objeto. 


e DataTextField. Hace referencia al campo del origen de datos que proporcio- 
na el contenido que mostrarán los elementos de lista. 
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DataTextFormatString. Hace referencia a la cadena de formato que especi- 
fica cómo se mostrarán los datos enlazados al control. 


DataValueField. Hace referencia al campo del origen de datos que propor- 
ciona el valor de cada elemento de lista. 


DataBind(. Este método enlaza un origen de datos al control de servidor pa- 
ra el que es invocado y a todos los elementos secundarios de ese control. 


SelectedIndex. Índice del elemento seleccionado. 
SelectedItem. Elemento seleccionado. 


SelectedValue. Valor del elemento seleccionado (el almacenado en el campo 
DataValueField). La expresión SelectedItem. Value devuelve el mismo valor. 


El índice del elemento seleccionado por el usuario en el control DropDown- 


List viene dado por la propiedad SelectedIndex, elemento que se podrá obtener 
de la colección Items del control. 


Según lo expuesto, nuestro origen de datos, colección de objetos profesor ob- 


tenidos tras una consulta sobre la entidad profesores del contexto de datos (tabla 
profesores de la base de datos), lo asignaremos a la propiedad DataSource de 
IsProfesor; el campo nombre de la entidad, a la propiedad DataTextField; y, fi- 
nalmente, invocaremos al método DataBind de /sProfesor para activar el enlace. 
Para ello, añada el controlador del evento Load de la página web y edítelo como 
se indica a continuación: 


protected void Page_load(object sender, EventArgs e) 


( 


using (var bd = new ContextoTutorias()) 


( 


Database.SetInitializer<ContextoTutorias>(new IniciarBaseDeDatos()); 
// Consulta 
var profs = 
from prof in bd.profesores 
select prof; 
// Enlace al origen de datos 
IsProfesor.DataSource = profs.Tolist(); 
IsProfesor.DatalextField = "nombre"; 
IsProfesor.DataBind(); 





Si ahora ejecuta la aplicación observará que el control /sProfesor muestra la 


lista de profesores obtenida de la base de datos. 
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También podríamos haber invocado al método Page.DataBind en lugar de a 
Control.DataBind. La diferencia principal entre estos dos métodos es que, des- 
pués de llamar al método Page.DataBind, todos los orígenes de datos se enlazan 
a sus controles de servidor. 


Enlaces de datos en ASP.NET 


El enlace a datos es una característica que nos permite asociar un origen de datos 
con un control para que este muestre automáticamente los datos; un ejemplo lo te- 
nemos justo en el apartado que acabamos de finalizar. Recuerde también que, an- 
teriormente, dedicamos todo un capítulo, Enlace de datos en Windows Forms, en 
el que también se expusieron este tipo de conceptos, aunque en ese caso fue para 
aplicarlos a Windows Forms. 


Los enlaces en ASP.NET podemos realizarlos en el fichero de código subya- 
cente, caso del ejemplo anterior, o en la propia página HTML: enlaces declarati- 
vos. Por ejemplo, el enlace programático realizado en el apartado anterior podría 
realizarse de forma declarativa así: 


<asp:DropDownList ID="1sProfesor" 
DataSource=" 
DatalextField="nombre"” 
runat="server" Width="296px" Font-Size="Medium"> 
</asp:DropDownList> 


donde el origen /sProfs lo declararíamos así: 


public partial class _Default : System.Web.Ul.Page 
( 
public Listproresor> IIsPirors i gets sets! 


protected void Page_lLoad(object sender, EventArgs e) 
( 
using (var bd = new ContextolTutorias()) 


( 


Database.SetInitializer<Contextolutorias>»(new IniciarBaseDeDatos()); 


var profs = 
from prof in bd.profesores 
select prof; 


IsProfs = profs.Tolist(); 
IsProfesor.DataBind(); 
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Expresiones de enlace de datos 


Las expresiones de enlace de datos permiten crear enlaces (en lenguaje declarati- 
vo) entre una página ASP.NET, incluyendo las propiedades de los controles de 
servidor, y un origen de datos. Dichas expresiones se resuelven cuando se llama al 
método DataBind de un control o de la clase Page, excepto para los controles de 
lista, como GridView, DetailsView y FormView, donde se resuelven automáti- 
camente durante su evento PreRender solo cuando se enlazan a un control origen 
de datos (por ejemplo, SqlDataSource) mediante la propiedad DataSourcelD, 
por lo que, en este caso, no es necesario llamar al método DataBind de forma ex- 
plícita (no sucede lo mismo cuando el enlace con el origen de datos se hace por 
medio de la propiedad DataSource). 


Para un enlace declarativo ASP.NET utiliza la sintaxis: <%# %>. Todas las 
expresiones de enlace de datos, independientemente de dónde las coloquemos, 
deben estar contenidas entre estos caracteres, y pueden resumirse así: 


<prefijo:etiqueta propiedad="<%i/ expresión %>" runat="server" /> 
o bien 
literal-texto <%i expresión %> 
Veamos algunos ejemplos: 
e Propiedad simple: 
<asp:TextBox ID="TextBox1" Text="<%i/ id %>" runat="server" /> 
e Colección: 
<asp:ListBox id="List1" DataSource="<%i col %>" runat="server"> 


e Expresión: 


Nombre y apellidos: <%ł (alum.nombre + + alum.apellidos) %> 


e Resultado del método: 
Nota obtenida: <%jif ObtenerNotalalumnoID) %> 
Controles de lista enlazados a datos 


Denominamos “controles de lista” a los controles de servidor web que se pueden 
enlazar con colecciones de objetos que admitan la interfaz IEnumerable, IColle- 
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ction o IListSource. Un ejemplo es el control GridView. Todos los controles de 
lista enlazados a datos ofrecen las propiedades DataSource y DataMember, cuyo 
significado ya fue expuesto anteriormente. 


Ahora bien, cuando trabajemos con colecciones de objetos en lugar de con da- 
tos elementales, tendremos que enlazar sus propiedades utilizando métodos como 
Eval, enlace en una sola dirección, o Bind, enlace en las dos direcciones. Tales 
objetos pueden ser mostrados en filas en algún control de lista, permitiendo inclu- 
so utilizar un formato personalizado mediante una plantilla para aquellas propie- 
dades de los mismos que se desee mostrar. Por ejemplo, el siguiente código define 
un control GridView que muestra los nombres de los objetos profesor de la co- 
lección IsProfs. 


<asp:GridView ID="GridView1" AutoGenerateColumns="false" 


DataSource="<%ik TsProfs 22" runat="server"> 
<Columns> 


<asp:TemplateField HeaderText="Nombre"> 
<ItemTemplate> 


</ItemTemplate> 
</asp:TemplateField> 
</Columns> 
</asp:GridView> 


El método Eval solo se puede utilizar dentro de una plantilla de un control de 
lista enlazado a datos, como GridView, DetailsView y FormView; esto es, no se 
puede utilizar en el nivel de página (las plantillas permiten personalizar los con- 
troles de servidor y son utilizadas normalmente con expresiones de enlace de da- 
tos). Este método devuelve una cadena que contiene el valor del campo de datos 
del registro actual en el origen de datos. Tiene un segundo parámetro opcional que 
permite especificar un formato para la cadena devuelta (este parámetro tiene la 
misma sintaxis definida para el método Format de la clase String): 


<ItemTemplate> 

<asp:Label ID="Label1" runat="server" 
Text="<%}# Eval("Fecha","{0:dd/MM/yyyy}")%>? /> 
<ItemTemplate> 





La expresión de enlace de datos utilizada anteriormente en el GridView para 
acceder al contenido de la propiedad nombre de los objetos profesor puede espe- 
cificarse también así: 


<%ł DataBinder.Eval(Container.Dataltem, "nombre") %> 


Esto quiere decir que durante la ejecución, Eval llama al método Eval del ob- 
jeto DataBinder que hace referencia al elemento de datos actual (contenedor del 
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control enlazado a datos que contiene un registro completo; en nuestro ejemplo, 
una fila de un control GridView). Por ello, el método Eval solo se puede utilizar 
para el enlace dentro de las plantillas de un control enlazado a datos, no sucedien- 
do lo mismo con DataBinder.Eval, que también puede ser utilizado en un méto- 
do del código subyacente. 


El método Bind se utiliza cuando se pueden modificar los datos. Controles 
como GridView, DetailsView y FormView pueden utilizar automáticamente las 
operaciones de actualización, eliminación e inserción programadas en un control 
que actúe como origen de datos, como SqlDataSource (el uso de estos controles 
lo veremos en los capítulos siguientes). Para ello, el método Bind tiene que utili- 
zarse dentro de las propiedades EditltemTemplate o InsertItemTemplate del 
control enlazado a datos y suele emplearse con controles de entrada como Text- 
Box representando, por ejemplo, las filas de un GridView en modo de edición. 


<EditltemTemplate> 
<asp:TextBox ID="etNombre" runat="server" 

Text="<%j Bind("nombre") %>” /> 

</EditItemTemplate> 


A partir de la versión 4.5 de ASP.NET es posible declarar qué tipo de datos 
va a estar enlazado a un control mediante su propiedad ItemType: 





<asp:GridView ID="GridViewl1" AutoGenerateColumns="false" 
ItemType="ModeloDeEnlace.ModeloDeDatos.profesor" 
DataSource="<%i/ IsProfs %>" runat="server"> 


Establecer esta propiedad permitirá utilizar dos variables fuertemente tipadas 
frente a Eval y Bind que son, respectivamente, Item y Bindltem, para recibir to- 
dos los beneficios de la experiencia de desarrollo de Visual Studio, como ayuda 
inteligente, soporte para la navegación (como lr a la definición) y comprobación 
durante la compilación. 


Las variables fuertemente tipadas no permiten violaciones de los tipos de da- 
tos, es decir, son variables de un tipo concreto, que no se pueden usar como si 
fueran de otro tipo distinto a menos que se haga una conversión. 


Ahora podemos utilizar Item (enlace en una sola dirección) en lugar de Eval 
(observe la figura siguiente) y BindItem en lugar de Bind (enlace en las dos di- 
recciones). Como muestra la figura, conocer el tipo del objeto que va a ser enla- 
zado permite acceder de forma sencilla a sus miembros: 
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<asp:GridView ID="GridView1” AutoGenerateColumns="false" 
ItemType="profesor” 
DataSource="<%tt 1sProfs gs" runat="server"> 
<Columns> 
<asp:TemplateField HeaderText="Nombre"> 
<ItemTemplate> 
ea Item.| %> 
IE # apellidos 
</asp:Templat 


</Columns> © Equals 
</asp:GridView> © GetHashCode 
</form> © GetType 
</body> # id profesor 
© ToString 


66,9) 


También se puede utilizar “:” justo después de <%# para evitar problemas de 
seguridad (por ejemplo, ataques de cross-site scripting - XSS - inyección de códi- 
go “script” en las páginas web). 


<%= Item.nombre %> 


Modelo de enlace de ASP.NET 


El modelo de enlace, disponible a partir de la versión ASP.NET 4.5 (disponible 
para páginas web ASP.NET, porque ya existía en ASP.NET MVC), hace que sea 
muy fácil crear y mantener páginas web ricas en datos. En las versiones anteriores 
de ASP.NET, cuando se quería llevar a cabo operaciones tanto para recuperar da- 
tos como para actualizarlos, era necesario utilizar un control que actuara como 
origen de datos (lo estudiaremos en los capítulos siguientes), y si el escenario re- 
quería código personalizado para el manejo de los datos, entonces era necesario 
utilizar un control ObjectDataSource, con los inconvenientes que esto podía pre- 
sentar; por ejemplo, era necesario evitar tipos complejos y controlar las excepcio- 
nes en la ejecución de la lógica de validación. Ahora, un control de lista enlazado 
a datos soporta el modelo de enlace de ASP.NET. Esto quiere decir que se pueden 
especificar directamente en el control los métodos que llevarán a cabo las opera- 
ciones SELECT, UPDATE, INSERT y DELETE. Las propiedades del control de 
lista que hacen referencia a estos métodos son SelectMethod, UpdateMethod, 
InsertMethod y DeleteMethod (estas propiedades las proporciona también el 
control de origen de datos ObjectDataSource, según estudiaremos más adelante). 
El control de lista se hará cargo de llamar a esos métodos en el momento adecua- 
do durante el ciclo de vida de la página o bien a petición del usuario. Por ejemplo: 


<asp:GridView ID="gvProfes" runat="server" 
AutoGenerateColumns="false" 
ItemType="ModeloDeEnlace.ModeloDeDatos.profesor" 
DataKeyNames="id_profesor" 
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SelectMethod="0btenerProfesores"> 


En este ejemplo se puede observar que la propiedad SelectMethod del Grid- 
View hace referencia al método ObtenerProfesores que estará definido en el fi- 
chero de código subyacente. Cuando se ejecute la aplicación, se cargará la página 
y esta llamará automáticamente al método ObtenerProfesores. 


En palabras sencillas, el modelo de enlace de ASP.NET es una técnica que 
evita tener que escribir un montón de código para tomar un objeto de la capa de 
negocio y asignarlo a un control de lista de la interfaz gráfica de usuario con la in- 
tención de realizar operaciones automáticas de lectura o escritura sobre los datos 
procedentes del origen de datos. 


Vamos a ver una introducción de lo que representa este modelo haciendo un 
pequeño ejemplo. En este caso, vamos a crear un proyecto de aplicación web (Ar- 
chivo > Nuevo > Proyecto > VCH > Web > Aplicación web vacía de ASP.NET) 
denominada ModeloDeEnlace, para que pueda comparar con el proyecto de sitio 
web que hicimos anteriormente. Como tenemos un proyecto vacío, vamos a añadir 
una página web denominada WebForml.aspx; será nuestra superficie de diseño. 


Este ejemplo trabajará sobre la tabla profesores de la base de datos que crea- 
mos anteriormente para, inicialmente, mostrar esos datos en WebForml. Según 
esto, empezaremos por instalar EF en la aplicación y después, utilizando Code 
First, crearemos la clase de entidad profesor (observe que ahora tiene tres miem- 
bros) que definirá el modelo de entidades que guardaremos en una carpeta Mode- 
loDeDatos que añadiremos al proyecto. Al tratarse de un proyecto, vamos 
también a especificar que la clase pertenece al espacio de nombres ModeloDeDa- 
tos definido por la carpeta: 


namespace ModeloDeEnlace.ModeloDeDatos 
( 

[Table("profesores")] 

public class profesor 

( 
// Propiedades correspondientes a las columnas de la tabla asociada 
[Key] 
public int id_profesor { get; set; ) 
public string nombre { get; set; ) 
public string apellidos [ get; set; } 





Una vez definido el modelo de entidades, creamos el contexto de objetos de- 
finido por la clase ContextoTutorias derivada de DbContext de EF y la clase /ni- 
ciarBaseDeDatos derivada de DropCreateDatabaselfModelChanges que permita 
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iniciar la base de datos con unos datos de prueba. Estas clases son las mismas que 
escribimos anteriormente, con la diferencia de que ahora pertenecerán al mismo 
espacio de nombres que la clase profesor. Finalmente, para que, inicialmente, se 
pueda construir la base de datos, escribiremos el controlador del evento Load así: 


protected void Page_load(object sender, EventArgs e) 
( 
if (IsPostBack) return; 
using (var bd = new ContextoTutorias()) 
{ 
Database.SetInitializer<ContextoTutorias>(new IniciarBaseDeDatos()); 


) 


La propiedad IsPostBack de Page vale true si la página se carga como res- 
puesta a un valor devuelto por el cliente; en caso contrario, esto es, si es la prime- 
ra vez que se carga, es false. 


GridView 


Una vez construida la base de datos, estamos listos para recuperarlos y mos- 
trarlos en la página web, para lo cual vamos a utilizar un GridView. Este control 
se utiliza para mostrar los valores de un origen de datos en una tabla. Cada co- 
lumna del mismo representa un campo y cada fila representa un registro. Un 
GridView se puede enlazar a cualquier control que actúe como un origen de da- 
tos, como SqlDataSource, integra funciones de ordenación, de actualización y 
eliminación, de paginación, de selección de fila, permite acceder mediante pro- 
gramación a su modelo de objetos para establecer propiedades dinámicamente, 
controlar eventos, etc.; proporciona campos de clave, campos de datos para las co- 
lumnas de hipervínculo y admite la personalización de la apariencia a través de 
temas y estilos. 


La propiedad AutoGenerateColumns vale true por defecto, lo cual hace que 
se cree de forma automática una columna por cada campo del origen de datos. Si 
lo que se desea es controlar manualmente qué campos de columna tienen que apa- 
recer en el control GridView, hay que asignar a esta propiedad el valor false. 


Una columna es un objeto DataControlField. De esta clase se derivan los di- 
ferentes tipos de columna que se pueden utilizar: 


e  BoundField. Éste es el tipo de columna predeterminado y simplemente mues- 
tra el valor de un campo de un origen de datos. 


e  ButtonField. Muestra un botón de órdenes para cada registro que muestre el 
GridView con el fin de poder ejecutar una operación determinada. 
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e CheckBoxField. Muestra una casilla de verificación para cada elemento del 
control GridView. 


e CommandField. Muestra los botones de órdenes predefinidos para realizar 
operaciones de selección, edición o eliminación. 


e DynamicField. Representa un campo de datos que usa las características de 
datos dinámicos de ASP.NET, los cuales proporcionan características como 
validación de datos. Requiere instalar en el proyecto DynamicDataTempla- 
tesCS desde NuGet. 


e HyperLinkField. Muestra el valor de un campo en un origen de datos como 
un hipervínculo. 


e  ImageField. Muestra una imagen para cada elemento del control GridView. 


e TemplateField. Plantilla para personalizar el contenido para cada elemento 
del control GridView. 


Para definir una colección de columnas hay que agregar la etiqueta Columns 
y a continuación especificar los campos a mostrar para cada columna. 


<Columns> 
<asp:BoundField DataField="nombre" HeaderText="Nombre" /> 
<asp:BoundField DataField="apellidos" HeaderText="Apellidos"” /> 
</Columns> 


Algunos controles de servidor web, como GridView o ListView, permiten 
personalizar su apariencia utilizando plantillas. Una plantilla no es más que un 
conjunto de elementos y controles HTML. Por ejemplo, GridView tiene las plan- 
tillas EmptyDataTemplate, que define el contenido para la fila de datos vacía 
que se representará cuando el origen de datos no contiene registros, y PagerTem- 
plate, que define el contenido de la fila de paginación del control. En cambio una 
columna de tipo TemplateField admite una gran variedad de plantillas, como, por 
ejemplo, HeaderTemplate, para mostrar el encabezado de una columna; Item- 
Template, para mostrar un elemento en el control enlazado a datos; o Editltem- 
Template e InsertltemTemplate, para mostrar un elemento de la columna en 
modo de edición o en el modo de inserción, respectivamente. Estas plantillas, 
normalmente, se pueden editar desde el menú de tareas del propio control. 


También, si el origen de datos admite operaciones de editar, borrar o selec- 
cionar registros, los controles de servidor web, como GridView o DetailsView, 
pueden sacar provecho de esas operaciones invocándolas automáticamente por el 
simple hecho de habilitar el botón correspondiente para cada fila del control de 
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servidor por medio de las propiedades AutoGenerateEditButton, AutoGenera- 
teDeleteButton o AutoGenerateSelectButton, respectivamente. 


<asp:GridView ID="gvProfes" runat="server" 
AutoGenerateColumns="False" 
AutoGenerateEditButton="True" 
AutoGenerateDeleteButton="True"> 
<Columns> 


Después de esta introducción, colocamos en la página un GridView y lo di- 
señamos como se muestra a continuación: 


<body> 
<form id="forml" runat="server"> 
<div> 
<asp:GridView ID="gvProfes" runat="server" 
AutoGenerateColumns="false" 
ItemType="ModeloDeEnlace.ModeloDeDatos.profesor" 
DataKeyNames="id_profesor" 
SellectMethod="0btenerProfesores"> 
<Columns> 
<asp:BoundField DataField="nombre" HeaderText="Nombre" /> 
<asp:BoundField DataField="apellidos" HeaderText="Apellidos" /> 
</Columns> 
</asp:GridView> 
</div> 
</form> 
</body> 

















Obsérvense los valores de las propiedades SelectMethod, ItemType y Da- 
taKeyNames. El primero es el nombre del método que se ejecutará para recuperar 
los datos que mostrará el GridView cuando se cargue la página, el segundo es el 
nombre de la clase que define el tipo de los objetos que se van a enlazar, lo cual 
permitirá referirse a las propiedades de esta clase en el código XHTML, y el ter- 
cero se corresponde con una matriz que contiene los nombres de los campos de 
clave principal, separados por comas, de los elementos mostrados en el control. 
Esta propiedad hay que establecerla para que funcionen las características de ac- 
tualización y eliminación automática del control de servidor. 


Seleccionar datos 


El siguiente paso es añadir en el fichero de código subyacente el método, Ob- 
tenerProfesores, especificado en SelectMethod. Puede hacerlo de forma automá- 
tica haciendo doble clic en la opción Crear nuevo método que le será mostrada 
cuando trata de asignar un valor a SelectMethod: 
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SelectMethod=""> 


$s Re NS método> 


Según explicamos en el capítulo LINO, este método, para que recupere las fi- 
las de la tabla profesores, podemos escribirlo así: 


namespace ModeloDeEnlace 
( 
public partial class WebForml : System.Web.Ul.Page 
( 
1/ 


public IQueryable<profesor> ObtenerProfesores() 
( 
ContextoTutorias bd = new ContextoTutorias(); 
var consulta = bd.profesores; 
return consulta; 


1 
j 


Si ahora ejecuta la aplicación, observará un resultado análogo al siguiente: 





E 
e http://localhost:3¿ 


Ceballos Sierra 
Batanero Ochaita 
Lendinez Chica 

















Actualizar y eliminar datos 


Añadir las operaciones de actualizar y borrar registros en la base de datos es 
muy similar al proceso de recuperar datos. Especificamos los nombres de los mé- 
todos que ejecutarán esas operaciones en las propiedades UpdateMethod y Dele- 
teMethod. Y también podemos especificar la generación automática de los 
botones Editar y Eliminar que ejecutarán esas operaciones, estableciendo las pro- 
piedades AutoGenerateEditButton y AutoGenerateDeleteButton a true. 
Cuando el usuario haga clic en el botón Editar, esa fila pasará a modo de edición 
mostrando dos nuevos botones: Actualizar y Cancelar, que realizarán las opera- 
ciones indicadas por su nombre, y cuando haga clic en el botón Eliminar, esa fila 
será eliminada. 
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O e http://localhost:8899/WebForm1.asp 


lo | Nombre | Apellidos 
Eliminar Ceballos Sierra 








[Editar Eliminar Batanero Ochaita 
¡Actua im Cancelar] María del Mar Lendínez Chica 
Edi Eliminar [Marin [Knoblauch Revuelta 














Después de estas modificaciones en el diseño del GridView, el código 
XHTML se verá así: 


<asp:GridView ID="gvProfes" runat="server" 
AutoGenerateColumns="False" 
ItemType="ModeloDeEnlace.ModeloDeDatos.profesor" 
DataKeyNames="1id_profesor” 
SelectMethod="0btenerProfesores" 
UpdateMethod="ModificarProfesores" 
DeleteMethod="BorrarProfesores" 
AutoGenerateEditButton="True" 
AutoGenerateDeleteButton="True"> 
<Columns> 

















Si añadió los métodos por medio de la opción Crear nuevo método, observará 
que ya están implementados. Sólo falta completarlos siguiendo las instrucciones 
especificadas. Una vez completada la edición de los métodos ObtenerProfesores y 
ModificarProfesores, estos se verán según se muestra a continuación. 


Es imprescindible que el nombre de parámetro de cada uno de los métodos (id 
por defecto) coincida con el valor de la propiedad DataKeyNames; por lo tanto, 
en nuestro caso debe llamarse id_ profesor. 


public void ModificarProfesores(int id_profesor) 
( 
using (ContextoTutorias bd = new ContextolTutorias()) 
( 
profesor objProfesor = null; 
// Cargar el elemento 
objProfesor = bd.profesores.Find(id_profesor); 
if (objProfesor == null) 
( 
// No se encontró el elemento 
ModelState.AddModelError("", 
String.Format("No se encontró el elemento con id. (0)", 
id_profesor)); 





return; 
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TryUpdateModel(objProfesor); 
if CobjProfesor.nombre == null || 
objProfesor.apellidos == null) return; 
if (ModelState.IsValid) 
( 
// Guardar los cambios 
bd.SaveChanges():; 
) 
) 
) 


Este método es invocado automáticamente cuando el usuario hace clic en el 
botón Actualizar de una fila del GridView, y recibe en su parámetro id profesor 
el identificador del objeto profesor enlazado y mostrado por dicha fila. A conti- 
nuación, obtiene ese objeto profesor, identificado por el parámetro id_ profesor, 
del contexto de objetos, actualiza dicho objeto con los últimos datos introducidos 
por el usuario invocando al método TryUpdateModel y salva los cambios ejecu- 
tando el método SaveChanges del contexto de objetos. 


Como el objeto objProfesor se actualiza con los cambios introducidos invo- 
cando al método TryUpdateModel, este método se debe llamar desde un método 
especificado por la propiedad UpdateMethod o InsertMethod de un control en- 
lazado a datos. 


Vemos a continuación el método BorrarProfesores especificado por la pro- 
piedad DeleteMethod del GridView: 


public void BorrarProfesores(int id_profesor) 
( 
using (ContextoTutorias bd = new ContextolTutorias()) 
( 
var objProfesor = new profesor { id_profesor = id_profesor }; 
bd.Entry(objProfesor).State = System.Data.EntityState.Deleted; 
try 
( 
bd.SaveChanges():; 
) 
catch (DbUpdateConcurrencyException) 
( 
ModelState.AddModelError("", 
String.Format("No se encontró el elemento con id. (0)", 
id_profesor)); 
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Este otro método es invocado automáticamente cuando el usuario hace clic en 
el botón Eliminar de una fila del GridView, y recibe en su parámetro id_profesor 
el identificador del objeto profesor enlazado y mostrado por dicha fila. A conti- 
nuación, invoca al método Entry para obtener el objeto DbEntityEntry que hace 
el seguimiento de la entidad identificada por id_profesor para marcarla como eli- 
minada (véase el apartado El seguimiento de cambios del capítulo LINO). Los 
cambios, en este caso borrar las entidades marcadas como eliminadas, serán ejecu- 
tados cuando se invoque al método SaveChanges del contexto de objetos. 


Insertar datos (FormView) 


El control GridView no incluye la propiedad InsertMethod (que sí tienen 
otros controles como FormView, DetailsView o ListView), por lo que no permi- 
te añadir un nuevo registro utilizando el modelo de enlace. Como alternativa, en 
este ejemplo, vamos a utilizar un control FormView para esta operación. 


Un FormView permite editar, eliminar e insertar registros en un origen de da- 
tos, además de mostrar los valores de un registro individual utilizando plantillas 
definidas por el usuario. Para mostrar su contenido proporciona distintas plantillas 
(HeaderTemplate, ItemTemplate, EditltemTemplate, InsertltemTemplate, 
etc.), algunas de ellas opcionales y otras obligatorias, ya que siempre debe existir 
una plantilla en función del modo en el que se configure el control: edición (Edit), 
inserción (nsert) o solo lectura (ReadOnly); este modo será definido por su pro- 
piedad DefaultMode. Por ejemplo, un control FormView para admitir la inser- 
ción de registros debe definir la plantilla InsertItemTemplate. 


A diferencia del GridView, el control FormView no proporciona una manera 
de generar automáticamente botones de órdenes para realizar operaciones de ac- 
tualización, eliminación o inserción. Por lo tanto, hay que incluir estos botones 
manualmente en la plantilla adecuada del FormView y especificar las operaciones 
que se desea realizar (Cancel, Delete, Edit, Insert, New, Page o Update) a través 
de la propiedad CommandName de cada uno de estos botones. 


Como ejemplo, vamos a añadir a la página web un FormView configurado 
para realizar inserciones de nuevos registros, que muestre, al menos, una caja de 
texto para que un usuario pueda introducir el nombre para un nuevo profesor, otra 
para introducir el apellido y un botón que ejecute la operación de insertar. 
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) e http://localhost:8899/WebForm1.asp 


[> [| Nombre | Apellidos | 








[Editar Eliminar[María del MarjLendinez Chica 
Knoblauch Revuelta 











Nombre: [Isabella | Apellidos: [Ceballos González | [i 


El código XHTML que dé lugar al FormView requerido puede ser así: 

















<asp:FormView ID="FormViewl" runat="server" 
ItemType="ModeloDeEnlace.ModeloDeDatos.profesor" 
DefaultMode="Insert" 
InsertMethod="InsertarProfesor"> 
<Insertltemfemplate> 
Nombre: 
<asp:TextBox ID="tbNombre" runat="server" 
Text="<%j BindItem.nombre %>" /> 
Apellidos: 
<asp:TextBox ID="tbApellidos" runat="server" 
Text="<%}# Bindltem.apellidos %>"/> 
<asp:Button ID="Button1" runat="server" Text="Insertar" 
CommandName="Insert" /> 
</InsertlItemlemplate> 
</asp:FormView> 

















Observe que añadir la operación de insertar registros en la base de datos es 
muy similar al proceso de actualizar y borrar registros implementados en el 
GridView. Especificamos el nombre del método que ejecutará esa operación en la 
propiedad InsertMethod y añadimos el botón Insertar que invocará a este méto- 
do, InsertarProfesor, a través de la operación Insert asociada con el FormView y 
especificada por la propiedad CommandName de ese botón. 


public void InsertarProfesor() 
( 
using (ContextoTutorias bd = new ContextoTutorias()) 
( 
var objProfesor = new profesor(); 
TryUpdateModel(objProfesor); 
if (objProfesor.nombre == null || 
objProfesor.apellidos == null) return; 
if (ModelState.IsValid) 
( 
// Guardar los cambios 
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bd.profesores.Add(objProfesor); 
bd.SaveChanges():; 

// Recargar el GridView 
avProfes.DataBind(); 


Este método es invocado automáticamente cuando el usuario introduce los da- 
tos para el nuevo registro y hace clic en el botón Insertar incluido en el Form- 
View. A continuación, crea el nuevo objeto profesor y lo actualiza con los datos 
introducidos por el usuario invocando al método TryUpdateModel. El nuevo ob- 
jeto será añadido explícitamente al contexto de objetos y los cambios serán guar- 
dados en la base de datos tras ejecutar el método SaveChanges. 


Estado del modelo y validación 


En el código escrito anteriormente para insertar y modificar registros, habrá 
observado que los cambios solo se guardan si el estado del modelo es válido: 


if (ModelState.IsValid) 
( 
// Guardar los cambios 


) 


ModelState es un objeto, administrado por ASP.NET, que indica cuál es el es- 
tado del modelo: ¿es válido? Si es válido significa que los datos de la petición 
eran válidos y que se ha podido crear un objeto y rellenarlo con los datos actuali- 
zados; y si no es válido significa que no todos los datos de la petición eran váli- 
dos, por lo que hay que abortar la operación en curso devolviendo el control al 
usuario. Se trata de un objeto de tipo ModelStateDictionary, esto es, un diccio- 
nario de pares clave-valor, donde como clave se usa el nombre de la propiedad del 
modelo donde se origina el error, y como valor, una descripción de lo ocurrido. 


Este mecanismo es compatible con la utilización de los atributos de anotación, 
atributos que, según vimos en capítulos anteriores, permiten especificar qué pro- 
piedad del modelo se desea validar y qué tipo de validación se quiere aplicar. Por 
ejemplo, vamos a modificar la clase de entidad profesor del modelo de entidades 
de nuestra aplicación en el sentido siguiente: 


[Table("profesores")] 

public class profesor 

( 
// Propiedades correspondientes a las columnas de la tabla asociada 
[Key] 
public int id_profesor { get; set; } 
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[Required] 

public string nombre { get; set; ) 
[Required] 

public string apellidos [ get; set; } 


Ahora, utilizando atributos de anotación, se ha especificado que las propieda- 
des nombre y apellidos son requeridas; esto es, si el usuario no introduce el valor 
para alguna de ellas, la propiedad IsValid de ModelState devolverá false. Esto 
permitirá eliminar la sentencia: 


if (objProfesor.nombre == null || 
objProfesor.apellidos == null) return; 


en los métodos ModificarProfesores e InsertarProfesor. También podemos notifi- 
car al usuario del error ocurrido, información que guarda ModelState. Para ello 
basta con que añadamos a la página web un control de validación ValidationSu- 
mmary configurado para mostrar los errores del ModelState, lo que se consigue 
estableciendo su propiedad ShowModelStateErrors a true. 


<form id="forml" runat="server"> 
<asp:ValidationSummary ID="ValidationSummary1" runat="server" 
ShowModelStateErrors="true" /> 
</form> 


Si ahora ejecuta la aplicación y, por ejemplo, realiza una modificación dejando 
el campo apellidos de un determinado registro en blanco, se mostrará el mensaje 
“El campo apellidos es obligatorio”. 


18 
[€] G http://localhost:8899/WebForm1.aspx 


| | Nombre | Apelidos |] 
Eliminar 
Eliminar Inmaculada [Rodriguez Santiago | 

















Eliminar [Martin [Knoblauch Revuelta 

















Nombre: Apellidos: Insertar 

















» El campo apellidos es obligatorio. 
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Asistente para publicar un proyecto web ASP.NET 


Publicar una aplicación web construida a partir de la plantilla Aplicación web es 
igual que publicar una aplicación web construida a partir de la plantilla Sitio web, 
tema que explicamos en el apartado ¿Cómo se publica una aplicación web? ante- 
riormente en este mismo capítulo (eche una ojeada al mismo). Según explicamos 
en ese apartado, para publicar una aplicación web, simplemente hay que mover el 
proyecto web al directorio lnetpublwwwroot. 


Este proceso resulta muy sencillo si se utiliza el asistente para publicación de 
sitios/aplicaciones web que proporciona Visual Studio. Para lanzar este asistente, 
haga clic con el botón secundario del ratón sobre el nombre del proyecto web y 
elija la opción Publicar... (tiene que haber iniciado Visual Studio como adminis- 
trador). Después siga los pasos indicados por el asistente. Como ejemplo, vamos a 
publicar la aplicación web ModeloDeEnlace. 





Publicación web Y 


G Publicación web 
¿Está publicando en Windows Azure? 


Descargue su perfil de publicación o regístrese para obtener una cuenta gratuita 








Conexión 
¿Busca opciones de hospedaje? Visite nuestra galería de hospedaje web 





Configuración 


Previsualización Seleccionar o importar un perfil de publicación 





| y] | Importar... 





| Administra Nuevo perfil 








Nombre de perfil: 











ModeloDeEnlace 








| Cancelar 
le 








Publicar | Cerrar 
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Publicación web 


GO Publicación web 

















Perfil ModeloDeEnlace * 
E Método de publicación: | Web Deploy y 
Configuración 
Previsualización 
Servidor: localhost | 








Nombre del sitio: Default Web Site 





Nombre de usuario: 


Contraseña: 


Guardar contraseña 








Dirección URL de destino: | http://localhost 





Validar conexión | €) 























Publicación web 


GS Publicación web 
Perfil Configuración: E 2) y 


^A) Opciones de publicación de archivos 


Eliminar archivos adicionales en el destino 








Conexión 

















Precompilar durante la publicación Cor ar 














Previsualización 
Exdluir archivos de la carpeta App_Data 








Bases de datos 


m 


g= 


^l ContextoTutorias 





conexión remota 


Cadena d 





Utilice esta cadena de conexión en tiempo de ejecución (actualizar el 


S 











web.config) 
|_| Ejecutar migraciones de primer código (se ejecuta al iniciar la aplicación) 








Para publicar un modelo de Code First, se debe usar Code First Migrations. 


‘i 


o Obtener más información 


| 
Ce) a e) e 
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Publicación web [0 [unes] 
GO Publicación web 




















Perfil ModeloDeEnlace * y 
Conexión 
Archivos: localhost: Default Web Site/ModeloDeEnlace 
pS = c 5 € 
sonundan ¡El Nombre Acción Fecha de modificación Tamaño 
E bin\EntityFramework.dll Agregar 13/06/2013 21:21:04 1,07 MB 
T binModeloDeEnlace.dll Agregar 18/06/2013 20:14:42 8 KB 
v| packages.config Agregar 13/06/2013 21:21:07 1 KB 
[Y] Web.config Agregar 18/06/2013 20:37:24 1 KB 
Y] WebForm1.aspx Agregar 17/06/2013 18:38:44 1 KB 
m , 
Actualizar vista previa de archivo 
Bases de datos 


@ No se han seleccionado bases de datos para la 


Cons] Case) e) 




















Cuando haya finalizado el trabajo con el asistente y haya publicado la aplica- 
ción, podrá verificar que en el sitio web predeterminado se ha creado una carpeta 
virtual, en el ejemplo ModeloDeEnlace, vinculada con la carpeta física que con- 
tiene los ficheros que componen la aplicación web. El contenido de esta carpeta 
para nuestro ejemplo es el mostrado en la figura anterior. 


Es aconsejable que abra el administrador de IIS y verifique si el grupo de 
aplicaciones al que pertenece esta aplicación es el adecuado. Por ejemplo, esta 
aplicación utiliza el servicio de SQL Server que se inicia bajo la identidad Servi- 
cio de red (NetworkService), por lo tanto, dicha aplicación debe pertenecer a un 
grupo con esta identidad. 


Realizar el proceso anterior manualmente es obvio. Cree en el sitio web la 
carpeta en la que desea copiar la aplicación, por ejemplo UnetpublwwwrootMode- 
loDeEnlace, y copie en la misma las carpetas y ficheros de la aplicación web del 
proyecto, según muestra la figura anterior. Después, complete esta tarea especifi- 
cando el nombre del directorio virtual. Para ello, abra el administrador de IIS, se- 
leccione la carpeta ModeloDeEnlace en el sitio web, haga clic sobre ella con el 
botón secundario del ratón, seleccione la opción Convertir en aplicación y acepte 
los valores predeterminados. 


Para probar cómo se ejecuta la aplicación web, abra el navegador y escriba la 
URL: http:/Mocalhost/ModeloDeEnlace/WebForml.aspx. Probablemente obtendrá 
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un error indicando que el formato de la cadena de inicialización no se ajusta a la 
especificación. Una solución a esto es especificar la cadena de conexión a la base 
de datos según explicamos en el apartado Cadena de conexión del capítulo LINO. 
Por ejemplo, abra el fichero web.config y añada el siguiente código: 


<connectionStrings> 
<add name=" 
connectionString="Data Source=.1sqlexpress; Initial 
Catalog-BDModeloDeEnTace: 
Integrated Security=True" 


providerName="System.Data.Sq1CTient"/> 


</connectionStrings> 


y pase el nombre de la cadena de conexión como argumento al constructor de 
DbContext cuando se cree el contexto de objetos: 


public class ContextoTutorias : DbContext 

( 
public ContextoTutorias() : base("ccModeloDeEnlace") {} 
public DbSet<profesor> profesores { get; set; ) 


1 
$ 


A continuación, compile la aplicación y ejecútela desde Visual Studio (servi- 
dor local) para verificar que la base de datos, BDModeloDeEnlace, se construye 
sin problemas. Después publique las modificaciones y vuelva a ejecutarla desde el 
servidor IIS: Attp:/localhost/ModeloDeEnlace/WebForml.aspx. 


Dependiendo de su configuración, puede que ahora se le muestre un mensaje 
indicando que no se puede abrir la base de datos “BDModeloDeEnlace” solicitada 
por el inicio de sesión del usuario “NT AUTHORITY Servicio de Red”. Esto es 
porque este usuario no tiene acceso a la base de datos (la base de datos, proba- 
blemente se construyó bajo el usuario de Windows con el que se autenticó). Una 
forma fácil de dar permisos a este usuario es ejecutando el siguiente script según 
explicamos en el apartado Base de datos Microsoft SOL Server del capítulo Acce- 
so a una base de datos: 


CREATE LOGIN [NT AUTHORITYAServicio de Red] FROM WINDOWS 

USE BDModeloDeEnlace 

CREATE USER [Servicio de Red] FROM LOGIN [NT AUTHORITYAServicio de Red] 
GRANT CONNECT TO [Servicio de Red] 

EXEC sp_addrolemember *db_owner”, *Servicio de Red” 





La primera sentencia de este script solo es necesaria si la entidad de seguridad 
de servidor “NT AUTHORITY Servicio de Red” no existe. 


Ahora, la aplicación web se tiene que ejecutar ya sin problemas. 


CAPÍTULO 16 


O F.J.Ceballos/RA-MA 


FORMULARIOS WEB 


Los formularios web constituyen la parte de la tecnología de ASP.NET que per- 
mite crear interfaces de usuario para aplicaciones web. Estas interfaces no son 
más que páginas web programables como parte de dichas aplicaciones web. Al 
crear estas páginas, se pueden usar controles del lado del servidor para crear ele- 
mentos comunes de la interfaz de usuario y programarlos para que realicen las ta- 
reas necesarias. 


La utilización de este tipo de formularios simplifica el desarrollo de las apli- 
caciones web porque: 


e Proporcionan un modelo de programación basado en eventos en el servidor 
parecido al que conocemos de los formularios Windows. 


e Permiten una completa separación entre el formato HTML y la lógica de la 
aplicación, o código asociado a la página, que normalmente se escribe en un 
fichero separado. 


e Pueden ser diseñados sin escribir una línea de código utilizando Visual Studio 
o Visual Studio Express para Web. 


e Son compatibles con un amplio y útil conjunto de controles y componentes 
.NET que ofrecen un modelo coherente de objeto de tipo seguro. Además, el 
marco de trabajo se presta de manera natural a la extensibilidad mediante los 
componentes personalizados y de otros fabricantes. 


Un formulario web se ejecuta en el servidor donde reside, a petición de un 
cliente, tal como un explorador web tradicional (por ejemplo, Microsoft Internet 
Explorer o Mozilla Firefox), sobre el cual mostrará dicha interfaz (el cliente po- 
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dría ser también un dispositivo móvil). El hecho de que su proceso ocurra en el 
servidor, libera de la necesidad de crear versiones especificas de la interfaz de 
usuario para cada explorador. ¿Por qué? Porque el proceso de una página com- 
puesta por controles HTML y controles web generará el HTML estándar que reci- 
ben todos los exploradores web. Además del procesamiento, estos controles 
también encapsulan el mecanismo para conservar el estado durante los recorridos 
de ida y vuelta al servidor y activar eventos del servidor para varios eventos gene- 
rados en el cliente. 


Un formulario web es una página web ASP.NET. En el capítulo titulado 
ASP.NET vimos una introducción a las páginas web ASP.NET y a los controles 
HTML, de servidor web y de validación que se utilizan en la creación de cada una 
de ellas. También vimos cómo publicar una aplicación web, o lo que es lo mismo, 
cómo alojarla en un servidor web para que sea accesible desde cualquier punto de 
Internet. Y finalmente estudiamos cómo implementar la lógica de negocio para 
dotar a estas páginas de un dinamismo basado fundamentalmente en el enlace de 
los controles de servidor a los datos de una base de datos, enlace que resulta muy 
sencillo de implementar cuando se utiliza el modelo de enlace proporcionado por 
ASP.NET 4.5 y versiones posteriores. 


APLICACIÓN WEB ASP.NET 


ASP.NET es una plataforma web que proporciona todos los servicios necesarios 
para producir y administrar de forma dinámica formularios web. Estos formula- 
rios web, junto con otros componentes, formarán las aplicaciones web que se eje- 
cutan en un servidor web a petición de los usuarios. Visual Studio proporciona 
básicamente un diseñador de formularios web, un editor, controles y una herra- 
mienta de depuración, para facilitar la generación de aplicaciones, a las que, una 
vez alojadas en un servidor, se podrá acceder desde exploradores, también llama- 
dos navegadores, y otros dispositivos cliente como teléfonos móviles o tabletas 
digitales. Este tipo de desarrollos, con menos facilidades, pueden ser también rea- 
lizados desde Visual Studio Express para Web. 


¿Cómo facilita ASP.NET la generación de aplicaciones web? 


e  Proporcionando una abstracción de la interacción cliente-servidor web tradi- 
cional que permite programar aplicaciones mediante herramientas de diseño 
rápido de aplicaciones (RAD) y la programación orientada a objetos. 


e Eliminando los detalles de implementación relacionados con la separación de 
las partes cliente y servidor, presentando un modelo unificado que responde a 
los eventos de los clientes en el código que se ejecuta en el servidor. 
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e Manteniendo automáticamente el estado de la página, y de los controles que 
contiene, durante el ciclo de vida de la misma. 


Como ejemplo, vamos a crear un formulario web para que un alumno pueda 
consultar a través de Internet las notas de las asignaturas que ha cursado. Todos 
los datos (alumnos, asignaturas y notas) estarán almacenados en una base de da- 
tos. Para desarrollar esta aplicación web, suponiendo que la base de datos ya está 
creada, podemos seguir los pasos indicados a continuación: 


Crear un sitio web inicialmente vacío. 

Añadir un nuevo formulario web. 

Implementar la capa de acceso a los datos. 

Agregar los controles necesarios al formulario web. 
Escribir los controladores de eventos para los controles. 
Generar y ejecutar el formulario web. 












































f lea 
O e http://localhost/FormWebNotas Defau O y 20| | (2 Formulario web notas 
DNI: [1234567 ] 
PROGRAMACION AVANZADA v 
Consultar nota 
Nombre: Leticia Aguirre Soriano 
Nota: 7,5 
K Pi 














En el capitulo Acceso a una base de datos vimos distintos mecanismos para 
acceder a los datos de una base de datos; desde utilizar, junto con los componen- 
tes que conforman un proveedor de datos, sentencias SQL escritas directamente 
en la lógica de negocio, procedimientos almacenados, conjuntos de datos para al- 
macenar los resultados de las consultas, etc., hasta utilizar el lenguaje de consulta 
integrado LINQ con ADO.NET Entity Framework y los distintos mecanismos pa- 
ra generar el modelo de entidades representativo del modelo lógico de la base de 
datos, todo ello expuesto en el capítulo LINO. Según esto, de ahora en adelante 
seremos nosotros los que tendremos que elegir el modelo de acceso que más nos 
interese en cada caso. 
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Para este ejemplo, vamos a empezar creando, si aún no está creada, la base de 


datos bd_notasAlumnos a partir del script que utilizamos en el capítulo Acceso a 
una base de datos: 























alumnos asignaturas 
Y id_alumno Y id_asignatura 
nombre nombre 










alums_asigs 
Y id_alumno 
Y ¡d_asignatura 


nota 


A continuación, crearemos un nuevo proyecto sitio web. Para ello, abra el en- 
torno de desarrollo como administrador, seleccione la opción Archivo > Nuevo > 
Sitio web, la plantilla Sitio web vacío de ASP.NET, ubíquelo en el servidor IIS 
(ubicación web: “HTTP”, solo si tiene instalado IIS en su equipo, si no lo tiene, 
seleccione “Sistema de archivos”) y póngale como nombre FormWebNotas, por 








ejemplo. 
F nl 
Nuevo sitio web [0 es 
b Reciente .NET Framework 4.5 ~ Ordenar por: Predeterminado + 3 |$=] Buscar en la Plantil ® > 
4 Instalado Ca EENE 
$ Sitio web vacío de ASP.NET Visual C# Tipo: Visual CH 
4 Plantillas Sitio web vacío 
[| 
Visual Basic el Sitio de ASP.NET Web Forms Visual CF 
Visual CF ce 
Ejemplos [5] Sitio web ASP.NET (Razor v1) Visual CF 
ce 
D En línea @ Sitio web de ASP.NET (Razor v2) Visual C# 
ee 
6 Sitio web de entidades de datos di... Visual C# 
e. 
cs 
œ Servicio WCF Visual C# 
=c: 
all] Sitio web de informes ASP.NET Visual C# 
Ubicación web: HTTP ~ http://localhost/FormWebNotas < Examinar... 
i| | Cancelar | 
L 























Suponiendo que tiene instalado IIS en su equipo (caso del autor), puede optar 
por poner directamente el nombre de la aplicación, según muestra la figura ante- 
rior (se creará una carpeta con ese nombre en C:\inetpub\wwwroot) o hacer clic en 
el botón Examinar, seleccionar la ubicación ZIS local, seleccionar el sitio web 
donde se va a alojar la aplicación (normalmente Default Web Site) y hacer clic en 
el botón Crear nueva aplicación web (barra de herramientas superior derecha); se 
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creará una carpeta a la que puede poner el nombre que desee (FormWebNotas en 
nuestro ejemplo). Finalmente, haga clic en el botón Abrir para volver al diálogo 
Nuevo sitio web. 





Elegir ubicación 









Al Servicios de Internet Information Server locales 


Seleccione el sitio web que desee abrir. 


Sistema de 
archivos 


yx 


Crear nueva 





aplicación web 





E Sitios de IIS 

4 (8 Default Web Site 
= aspnet_client 

E Sitios de IIS Express 





Sitio FTP 











El servidor JIS local tiene como dirección IP 727.0.0.1, la cual tiene asignado 
el nombre localhost. Por lo tanto, la dirección de acceso a la aplicación que aca- 
bamos de crear es cualquiera de las dos siguientes: 


http: //localhost/FormWebNotas 
http://127.0.0.1/FormWebNotas 


Observe que no hemos especificado la página de inicio Default.aspx, esto es: 


http://localhost/FormWebNotas/Default.aspx 


porque no es necesario, ya que esta página, además de otras como index.htm o in- 
dex.html, están especificadas por el Administrador de IIS como documentos pre- 
determinados, según puede observar en la figura siguiente: 


AGE mee Ver Ayuda 
es 208 


2 Administración del equipo 








OO [0 > FICEBALLOS-PC » Sitios » Default Web Site » 





a Ü Herramientas del sisten] 
> @ Programador de tar Conexiones 
> E Visor de eventos [a] 





(=) Documento predeterminado 





& Carpetas compartida 

HE Usuarios y grupos Ic 

(5) Rendimiento 

Eh Administrador de dis 
a 3 Almacenamiento 


Nombre Tipo de entrada 

[57 Administración de di b ə FormWebNotas Default.htm Heredada 

a Ty Servicios y Aplicaciones Default.asp Heredada 
Y) Administrador de In OREA Heredada 

% e index.html Heredada 

ti 
S Con a iisstart.htm Heredada 
Ñ Administrador de co default.aspx Heredada 





-84 FJICEBALLOS-PC (ficeballos-P! 
{Ê Grupos de aplicaciones 
4-0] Sitios 
a -@ Default Web Site 
a aspnet_dient 











Utilice esta característica para especificar los archivos 
predeterminados que se devolverán cuando un cliente no 
solicite un nombre de archivo específico. Establezca los 
documentos predeterminados en orden de prioridad. 
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Crear la capa de acceso a datos 


La capa de datos estará formada por el modelo generado con ADO.NET Entity 
Framework a partir de la base de datos bd_notasAlumnos, según explicamos en el 
capítulo LINO. Dicho modelo será almacenado en la carpeta App_Code del sitio 
web a propuesta de ASP.NET. 


¿Qué es App_Code? ASP.NET reconoce ciertos nombres de carpetas que po- 


demos utilizar para ciertos tipos de contenido. Estas carpetas son las siguientes: 


App_Browsers. Sirve para almacenar los ficheros utilizados por ASP.NET pa- 
ra identificar un determinado navegador y determinar sus posibilidades. 


App_Code. Código fuente para los componentes o clases que queremos com- 
pilar como parte de la aplicación. ASP.NET compila el código de esta carpeta 
cuando las páginas son solicitadas. El código que está en esta carpeta es au- 
tomáticamente referenciado en la aplicación. 


App_Data. Carpeta para almacenar ficheros .mdb (Access), .mdf (SQL Ser- 
ver), XML y otros ficheros de datos. 


App GlobalResource. Carpeta para los ficheros de recursos (.resx) que serán 
accedidos desde el código del programa. 


App _LocalResources. Carpeta para los ficheros de recursos (.resx) que están 
vinculados a una página específica. 


App_Themes. Carpeta que almacena los ficheros que definen la apariencia de 
las páginas y controles web. 


App_WebReferences. Carpeta para las clases que definen los proxy, esquemas 
y otros ficheros asociados con la utilización de un servicio web. 


Bin. Carpeta para los ensamblados (ficheros .dl/). En ella podemos guardar 
controles, componentes u otro código que necesitemos referenciar de forma 
automática en la aplicación. 


Según lo expuesto, agregue al proyecto un nuevo elemento de tipo ADO.NET 


Entity Data Model y configúrelo para obtener el modelo de datos deseado: 


CAPÍTULO 16: FORMULARIOS WEB 797 





Asistente para Entity Data Model 





4) Elegir los objetos y la configuración de la base de datos 


¿Qué objetos de la base de datos desea incluir en su modelo? 
Y] dbo 

vg alumnos 

vg alums_asigs 

VI asignaturas 

Hoy Vistas 

Fey Funciones y procedimientos almacenados 







































































v| Poner en plural o en singular los nombres de objeto generados 











[Y] Incluir columnas de clave externa en el modelo 





Espacio de nombres del modelo: 


bd_notasAlumnosModel 


i < Anterior Siguiente > | Einalizar Cancelar 














Vamos a echar un vistazo al modelo de datos generado. Observamos que está 
compuesto por las entidades alumno, alum_asig y asignatura y por el contexto de 
objetos bd_notasAlumnosContexto: 


Vista de cl 





= 0 o- % 
<Búsqueda> ~- P 
4 E http://localhost/FormWebNotas/ 

b E Referencias del proyecto 

b fg alum_asig 

b fg alumno 

b %; asignatura 


3 bd_notasAlumnosContexto 


€ bd_notasAlumnosContexto() 
©, OnModelCreating(System.Data.Entity.DbModelBuilder) 
# alumnos 
# alums_asigs 
# asignaturas 
4 > 
Explorador de solu... Vista de clases Explorador de servi... 
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Añadir un nuevo formulario web 


Un formulario es el componente que utilizará la aplicación para mostrar los datos 
al usuario y permitirle interactuar con los mismos. 


Para añadir un nuevo formulario a la aplicación, haga clic sobre el nombre del 
proyecto utilizando el botón secundario del ratón y seleccione, en el menú contex- 
tual que se muestra, la orden Agregar > Formularios Web Forms; escriba un 
nombre para el mismo o acepte el predefinido, Default, y haga clic en Aceptar. 
Antes de continuar, vamos a echar una ojeada a las carpetas y ficheros que se han 














creado: 
Explorador de soluciones y Ax 
a ©- w| > 4 
Buscar en el Explorador de soluciones (Ctrl+”) p~- 





E] Solución 'FormWebNotas' (1 proyecto) 
4 ®© http://localhost/FormWebNotas/ 
>Ò ml App_Code 
ò Eg Bin 
1) Default.aspx.cs 
Y packages.config 
$9 vwd.webinfo 
A Web.config 





Explorador de solu... Vista de clases Explorador de servi... 


Puede comprobar en el Explorador de soluciones que en la carpeta Form- 
WebNotas está la carpeta App_Code (se creó para almacenar la capa de acceso a 
datos que generamos anteriormente), los ficheros Default.aspx y Default.aspx.cs, 
y el fichero de configuración Web.config. El fichero fuente Default. aspx.cs con- 
tiene el código C# que da soporte al formulario Default. aspx. 


Diríjase ahora al diseñador de formularios. Está mostrando el código XHTML 
del formulario web. En su parte inferior muestra los botones Diseño, Dividir y 
Código, que muestran diferentes vistas del fichero Default.aspx; la primera mues- 
tra los elementos tal cual serán visualizados; la tercera, el código HTML extendi- 
do que da lugar a dichos elementos; y la segunda, las dos anteriores. Se puede 
trabajar en cualquiera de las vistas. Cada una de ellas se actualiza con los cambios 
efectuados en la otra. 


Finalmente, diríjase a la carpeta C:l/netpublwwwrootlFormWebNotas y ob- 
serve cómo se ha alojado su aplicación en el sitio web predeterminado. 
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Descripción de un formulario web ASP.NET 


Para crear una aplicación web no estamos obligados a utilizar herramientas RAD 
(Rapid Application Development — desarrollo rápido de aplicaciones), aunque esta 
sea la opción más rápida y segura; basta con que tengamos instalados los servicios 
de IIS, NET Framework SDK (debe instalarse IIS antes que .NET Framework 
SDK) y un editor de texto para escribir el código de la aplicación que podremos 
compilar y ejecutar desde la línea de órdenes. Esto es así porque las páginas de 
formularios web se generan mediante la tecnología ASP.NET, y ASP.NET está 
incorporado en .NET Framework SDK, por lo que todo el marco de trabajo está 
disponible para cualquier aplicación ASP.NET. Las aplicaciones pueden crearse 
en cualquier lenguaje compatible con CLR. 


Un formulario web ASP.NET es un fichero de texto con extensión aspx. Al- 
macena los elementos visuales, esto es, la interfaz gráfica de usuario, aunque tam- 
bién podría incluir código Cf. Para editar este fichero puede ayudarse de 
cualquier editor de texto/HTML,; incluso un fichero HTML existente puede con- 
vertirse en un formulario web ASP.NET simplemente cambiando su extensión a 
.aspx (no se necesita ninguna modificación del código). Como lo habitual es que 
el código C# que da soporte al formulario esté almacenado en un fichero .cs, co- 
nocido como “fichero de código subyacente”, la relación del fichero .aspx con el 
fichero .cs se establece con directrices incluidas en la parte superior de la página: 


<%@ Page 
CodeFile="Default.aspx.cs” 
Inherits="_Default" 

%> 


<html> 
</html> 


Como se puede observar, debe utilizarse la directriz @ Page y utilizar los 
atributos CodeFile e Inherits. 


CodeFile especifica la ruta del fichero de código subyacente que se compilará 
dinámicamente cuando se solicite la página. Este atributo solo es válido para las 
páginas compiladas. 


Inherits indica la clase en el fichero de código subyacente que define la lógi- 
ca de negocio del formulario. Esta clase tiene que derivarse de la clase Page del 
espacio de nombres System.Web.UI. La clase Page se asocia a ficheros que tie- 
nen la extensión .aspx. 
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El fichero .cs almacena la clase, en nuestro ejemplo Default, que define la 
lógica de negocio del formulario. Ambos ficheros dan lugar a un único elemento 
denominado “formulario web” o “página web ASP.NET”. 


public partial class _Default : System.Web.UlI.Page 
( 

td 
) 


Según hemos indicado anteriormente, también es posible incluir el código C# 
en el propio fichero .aspx entre las etiquetas <script runat="server"> y 
</script>. En este último caso tendríamos que añadir el atributo Language de la 
directriz Page para especificar el lenguaje utilizado (VB, CF, etc.; por ejemplo, 


Language="C#"). 


<%@ Page Language="C#" %> 
<script runat="server"> 
// Insertar el código C# aquí 
JE dz 
</script> 


<html> 
</html> 
No obstante, esta forma de proceder no se suele utilizar por ir en contra de los 


buenos principios de programación como es el de separar la capa de presentación 
de la lógica de negocio. 


Agregar controles y texto a la página 


El siguiente paso es añadir a la vista Diseño los elementos que mostrará el formu- 
lario, y establecer sus propiedades en la ventana Propiedades. 


Para agregar un control al panel de Diseño, diríjase al Cuadro de herramien- 
tas, selecciónelo del panel HTML, del panel Estándar (controles de servidor web) 
o de otro panel y arrástrelo sobre la vista Diseño. Lo general es utilizar controles 
de servidor ASP.NET por la funcionalidad que aportan, según vimos en el capítu- 
lo ASP.NET, esto es, los controles de servidor se procesan en el servidor, lo que 
permite escribir código para establecer sus propiedades y para controlar los even- 
tos que generen. 


Para colocar los controles en el formulario web disponemos de dos modos: 
modo cuadrícula (grid layout) y modo flujo (flow layout). De manera predetermi- 
nada, un control tiene asignado el modo flujo. En este modo los elementos fluyen 
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de izquierda a derecha en la línea, y de arriba abajo en la página. En cambio, en el 
modo cuadrícula puede arrastrar controles a la página y colocarlos utilizando sus 
coordenadas absolutas x e y. Para cambiar a modo cuadrícula (posición absoluta o 
relativa) seleccione el control en el panel de Diseño y elija posición Absoluta de 
entre las opciones que se visualizan al ejecutar la orden Establecer posición del 
menú Formato del entorno de desarrollo. 


Los modos cuadrícula y flujo tienen ventajas e inconvenientes. Cualquier ex- 
plorador web puede mostrar documentos HTML que utilicen el modo flujo; ade- 
más, cuando se ajuste el tamaño de la página, los controles se volverán a colocar. 
El modo cuadrícula proporciona un mayor control sobre el diseño de la página, 
pero no es tan flexible; esto es, si el tamaño de la página se hace más pequeño o la 
resolución del equipo es menor que la del equipo de desarrollo, puede que solo se 
muestre una parte de la página. No obstante, el autor utilizará este modo. 


En una aplicación profesional, lo habitual es no utilizar coordenadas absolu- 
tas, sino recurrir al uso de diferentes elementos HTML, como <div>, <spam>, 
<p>, <table>, <tr>, <td>, <ul>, <li>, etc., o elementos ASP.NET como Panel, 
que nos ayuden a distribuir los componentes en las distintas zonas de la página, y 
a las hojas de estilo para describir cómo será la presentación y el formato de los 
componentes de la página web, pero el tema de diseño se sale fuera de los objeti- 
vos de este libro, aunque haremos una pequeña introducción más adelante en el 
capítulo titulado Páginas maestras. 


Continuemos con el diseño. Una vez colocado un control sobre el formulario, 
para establecer sus propiedades, selecciónelo y, a continuación, escriba los valores 
adecuados en la ventana de Propiedades. También puede mejorar la vista del con- 
junto de controles del formulario utilizando las órdenes del menú Formato, o bien 
de la barra de herramientas Diseño. 


Según lo explicado, y observando la figura siguiente correspondiente al for- 
mulario web que deseamos diseñar, añada al panel de Diseño los controles indica- 
dos en la tabla siguiente con las propiedades especificadas: 


Propiedad 
Lista desplegable (1D) IsdAsignatura 


Text Consultar nota 
Text Nombre: 
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Etiqueta (1D) etNota 
Text Nota: 


Etiqueta (1D) etError 
Text Error: 





Finalmente, haga clic sobre el formulario y cambie su propiedad Title al valor 
Formulario web notas. 





DOTA Default.aspx.cs X 


DN: 


Consultar nota 
Nombre: 
Nota: 
Error: 


v 
4 > 


[5 Diseño | a Dividir | ° Código 4 [<body> ||<formitform1>||<div>| <asp:DropDownList*sdAsig...> [h] 






































Ahora, si abre el explorador y solicita la ejecución de esta página al servidor, 
este la compilará y la ejecutará enviando el código HTML resultante al explorador 
para que muestre la página (véase el apartado Modelo de ejecución de una página 
web ASP.NET en el capítulo ASP.NET). 


Cuando se compila un formulario web, ASP.NET analiza la página y su códi- 
go, genera una clase nueva dinámicamente y después la compila. La clase genera- 
da dinámicamente se deriva de la clase Page de ASP.NET, pero se extiende con 
los controles, el código y el texto HTML estático incluido en el fichero .aspx. 


Ciclo de vida de una página 


Cuando un usuario solicita una página .aspx (un formulario web), el servidor car- 
ga esa página y una vez completada la solicitud la descarga. El explorador presen- 
ta la página al usuario y este interactúa con ella, causando que se envíe de nuevo 
al servidor por cada acción que necesite procesamiento, como, por ejemplo, al ha- 
cer clic en un botón Enviar; procesada la acción, la página será devuelta al explo- 
rador. Entre las acciones de ida y vuelta ASP.NET guarda el estado de la página 
utilizando la propiedad Control.ViewState (estado de vista). 
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Para saber si es la primera vez que se procesa la página o se trata de una devo- 
lución de datos (la página ha sido enviada de nuevo al servidor en respuesta a al- 
guna acción) hay que examinar la propiedad Page.IsPostBack. Esta propiedad 
vale false cuando es la primera vez que se procesa la página. 


if (lIsPostBack) 

( 
// Es la primera vez que se procesa la página, por lo tanto 
// es seguro iniciar los controles por primera vez. 


} 


El proceso de una página web (un formulario web) ocurre en varias etapas, 
que podemos resumir en las siguientes: iniciación, carga del estado de la vista, va- 
lidación, control de eventos, enlace de datos y descarga. Durante estas fases se 
producen los eventos Prelnit, Init, Load, eventos de los controles, PreRender y 
Unload, en el orden especificado. Los métodos para responder a estos eventos se 
pueden crear con cualquier nombre y enlazarlos explícitamente, o bien sobrescri- 
biendo los métodos OnPrelInit, OnInit, OnLoad, OnPreRender y OnUnload 
heredados de la clase base Page, o también se pueden enlazar implícitamente a los 
métodos que utilicen la convención de nomenclatura: Page evento (por ejemplo, 
Page Load); este último caso exige que la propiedad de página AutoEventWi- 
reup valga true. Cada uno de los controles de servidor ASP.NET tiene su propio 
ciclo de vida, que es similar al ciclo de vida de la página. 


Durante la etapa de iniciación ASP.NET primero crea la página y genera el 
evento Init, y a continuación genera el evento Load. Durante la creación de la 
página se crean todos los controles y si no es la primera vez que se carga la pági- 
na, esto es, si es una devolución de datos (Page.IsPostBack vale true) ASP.NET 
toma la información de estado de la vista y la aplica a todos los controles. El esta- 
do de la vista registra cada propiedad que haya cambiado. El evento Init se inter- 
cepta en raras ocasiones porque puede que los controles aún no hayan sido 
creados y la información de estado no haya sido cargada. El evento Load se gene- 
ra siempre, independientemente de si la página se solicita por primera vez o si se 
solicita como parte de una devolución de datos. 


En cuanto a la validación, ASP.NET incluye controles de validación que pue- 
den validar automáticamente otros controles relacionados con la entrada del usua- 
rio y mostrar mensajes de error si es necesario. Estos controles actúan después de 
que la página se carga, pero antes de que cualquier otro evento tenga lugar. No 
obstante, los controles de validación son en su mayor parte autosuficientes, lo que 
significa que no es necesario responder a los eventos de validación. En su lugar, 
puede examinar si la página es válida interrogando la propiedad IsValid de Page 
en otro controlador de eventos. 
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Llegamos a la etapa de control de los eventos. En este punto, la página está 
totalmente cargada y validada y ASP.NET responderá a todos los eventos que ha- 
yan tenido lugar desde la última devolución de datos. Por ejemplo, piense en la 
página de nuestro ejemplo, tiene una caja de texto (que no hace devolución de da- 
tos automáticamente cuando cambia su contenido porque tiene, de forma prede- 
terminada, su propiedad AutoPostBack a false) y un botón para realizar la 
devolución de datos (reenviar la página al servidor). Supongamos que modifica- 
mos el texto de la caja de texto y hacemos clic en el botón. En este punto, 
ASP.NET genera todos estos eventos y en este orden: Page.Init, Page.Load, 
TextBox.TextChanged, Button.Click, Page.PreRender y Page.Unload. 


En el capítulo ASP.NET dijimos que los enlaces de datos entre los controles 
de servidor y un origen de datos para los controles de lista, como GridView, De- 
tailsView y FormView, se resuelven automáticamente durante su evento Pre- 
Render solo cuando se enlazan a un control origen de datos (por ejemplo, a 
SqlDataSource) mediante la propiedad DataSourcelD, por lo que, en este caso, 
no es necesario llamar al método DataBind de forma explícita, cosa que sí hay 
que hacer para que se resuelvan los enlaces cuando el enlace con el origen de da- 
tos se hace por medio de la propiedad DataSource. Esto equivale a decir que to- 
dos los cambios (inserciones, eliminaciones o actualizaciones) se llevan a cabo 
después de que todos los eventos de los controles se hayan manejado, pero justo 
antes del evento Page.PreRender. Luego, tras el evento de Page.PreRender, los 
controles origen de datos realizan sus consultas para actualizar con los datos obte- 
nidos los controles enlazados. Esta forma de proceder tiene sentido porque si las 
consultas se ejecutaran antes de los cambios, podríamos terminar con datos obso- 
letos en la página web, pero presenta una limitación y es que ninguno de los otros 
controladores de eventos tiene acceso a los datos más recientes, ya que aún no han 
sido recuperados. 


El evento Page.PreRender es la última acción antes de obtener el HTML re- 
sultante antes de procesar la página. Esto es, durante esta etapa, la página y los 
controles están todavía disponibles, para que se puedan realizar los pasos de últi- 
ma hora, como el almacenamiento de información adicional en el estado de vista. 


Y justo al final del ciclo de vida de la página es cuando se obtiene el código 
HTML que será enviado al explorador para mostrarla al usuario con los cambios 
que se hayan producido. Antes de que la página se descargue se genera el evento 
Page.Unload. En este punto, los objetos de la página están todavía disponibles, 
pero el código HTML final ya no se puede cambiar. El controlador de este evento 
es útil para, si es necesario, hacer limpieza. Antes de que sea enviado el código 
HTML al explorador, se destruyen todos los objetos del formulario y se descarta 
toda la información específica del cliente, por lo que la información de una peti- 
ción no está disponible de manera predeterminada en la siguiente petición. 
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Modelo de eventos de ASP.NET 


Como se puede ver, el modelo de eventos de ASP.NET difiere bastante del de 
Windows Forms. En Windows Forms, el estado del formulario reside en memoria 
y la aplicación se ejecuta continuamente, por lo que se puede responder a cual- 
quier evento en el instante en el que se genera. En ASP.NET, las cosas ocurren 
por etapas y como consecuencia de ello los eventos son agrupados para ser proce- 
sados todos juntos en el orden esperado cuando la página sea devuelta al servidor. 


Debido a que los eventos de formularios web requieren una acción de ida y 
vuelta al servidor para procesarse, pueden afectar al rendimiento de la aplicación. 
Por ello, los controles de servidor ofrecen un conjunto limitado de eventos intrín- 
secos (normalmente solo el evento Click). 


Lo normal es que los eventos Click hagan que el formulario sea devuelto al 
servidor. En cambio, los eventos que notifican cambios en los controles de servi- 
dor HTML y web, como TextChanged en TextBox o CheckedChanged en 
CheckBox, se capturan pero no se envían inmediatamente; esto es, no provocan el 
envío de la página. En lugar de ello, el control los almacena en memoria caché 
hasta la próxima vez que se produzca un envío, instante en el que se procesa de 
nuevo la página en el servidor y se procesan todos los eventos pendientes. No 
obstante, se puede especificar que los eventos que notifican cambios en los con- 
troles de servidor produzcan el envío del formulario automáticamente para ser 
procesado. ¿Cómo? Poniendo la propiedad AutoPostBack del control a true. Só- 
lo algunos controles tienen esta propiedad. 


Añadir los controladores de eventos 


Llegados a este punto, pensemos en cómo se sucederán los hechos cuando un 
alumno solicite que se ejecute nuestra aplicación web desde un explorador: 


1. Se visualiza el formulario web. La lista desplegable muestra la lista de asigna- 
turas que el alumno puede consultar. 


2. El alumno escribe su DNI y selecciona de la lista la asignatura de la que quie- 
re consultar la nota. 


3. Después, hace clic en el botón Consultar nota. La página se envía al servidor 
para su proceso. Llegado a la etapa de control de eventos, ASP.NET procesa 
los eventos que se hayan producido si existe un controlador que responda a 
los mismos. Cuando la ejecución del código finalice, la página se vuelve a 
enviar al explorador con los cambios realizados por el código: la etiqueta et- 
Nombre mostrará el nombre del alumno, y la etiqueta etNota, la nota obtenida 
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en la asignatura seleccionada, o bien la etiqueta etError visualizará un mensa- 
je de error si fue esto lo que ocurrió. 


Una vez descrito cómo tienen que suceder las acciones, podemos pasar a es- 
cribir el código que permita procesar tales acciones. Esto requiere conocer cómo 
es el ciclo de vida de una página web, cosa que ya hemos explicado anteriormen- 
te. Según expusimos, cuando se carga el formulario web se produce el evento 
Load; la respuesta a este evento será la ejecución del método Page Load. Por lo 
tanto, este es el lugar idóneo para iniciar la lista [sd Asignatura con las asignaturas, 
y la etiqueta de error etError. 


Para añadir el controlador del evento Load, si no estuviera añadido, diríjase al 
explorador de soluciones y haga clic en el botón Ver código. Esto hará que se vi- 
sualice la página de código que muestra la figura siguiente. Observe que esta pá- 
gina expone en su parte superior dos listas desplegables: la de la izquierda 
contiene la lista de clases del formulario web, y la de la derecha, la lista de contro- 
les, propiedades y métodos del objeto seleccionado en la lista de la izquierda: 


Default.aspx ~ 
% Default » O, Page_Load(object sender, EventArgs e) 
using System; F, Applicationinstance 
using System.Collections.Generic 
using System.Linq; 
using System.Web; 9, Dni 
using System.Web.UI; O etError 


using System.Meb.UL.WebControls; go 
, etNom 









A btConsultarNota 





JO fp uwynr 


8 Epublic partial class Default : %etNota 





9 (1 @ formi 
10 E protected void Page Load(ob- © Label 
11 { ), Labeli 
12 e IsdAsignatura 
13 } O, Page_Load(object sender, EventArgs e) 
14 

i } FP, Profile 
Page_Load(object sender, EventArgs e) 
100% v~ 4 b 


Por ejemplo, en la figura se observa que el asistente ha añadido el controlador 
Page Load para controlar el evento Load del formulario. Complete este controla- 
dor como se indica a continuación: 


protected void Page_load(object sender, EventArgs e) 
( 
if (!lIsPostBack) 
( 
using (bd_notasAlumnosContexto contexto0bjs = 
new bd_notasAlumnosContexto()) 


lsdAsignatura.DataSource = contexto0bjs.asignaturas.ToList(); 
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lIsdAsignatura.DatalextField = "nombre"; 
lIsdAsignatura.DataValueField = "id_asignatura"; 
lIsdAsignatura.DataBind(); 
) 
) 


etError.Text = 


mu, 
, 


El método anterior obtiene la lista de asignaturas y se la asigna al control de 
servidor IsdAsignatura. Esta operación solo se hace la primera vez que se ejecuta 
la página. Observe también que el control DropDownList muestra el nombre de 
la asignatura (propiedad DataTextField) y guarda el valor de su identificador 
(propiedad DataValueField). 


Si ahora ejecuta la aplicación, el control /IsdAsignatura mostrará la lista de 
asignaturas. Si no es así, probablemente es porque no se puede abrir la base de da- 
tos solicitada por el inicio de sesión del usuario “NT AUTHORITY Servicio de 
Red”. Ya hablamos de esto al final del capítulo ASP.NET; no obstante, en el apar- 
tado Obtener acceso a la base de datos que se expone a continuación, se dan más 
detalles acerca de la solución propuesta para este problema. 


La finalidad de la aplicación es mostrar la nota de la asignatura seleccionada 
para el alumno identificado por su DNI. Por eso, cuando el alumno haya introdu- 
cido estos datos, hará clic en el botón Consultar nota, instante en el que la página 
será enviada al servidor. ASP.NET analizará el evento que se ha producido y si 
existe un controlador para ese evento, se ejecutará inmediatamente. 


La función de este controlador será buscar la nota de la asignatura selecciona- 
da por el alumno que se ha identificado. Para ello, este método creará el objeto 
contexto de objetos que permitirá interactuar con el modelo de entidades represen- 
tativo de la base de datos, y, utilizando como parámetros el identificador del 
alumno (ctDni. Text) y el de la asignatura (/sdAsignatura.Selectedltem. Value), rea- 
lizará una consulta que a continuación procesará con el fin de obtener los resulta- 
dos para mostrarlos en las etiquetas correspondientes de la página. 


Para escribir un controlador para el evento Click del botón btConsultarNota, 
diríjase al panel Diseño y haga doble clic sobre el botón. Puede hacerlo también a 
través del panel de eventos en la ventana de propiedades del botón. Después, 
complete dicho controlador como se indica a continuación: 


protected void btConsultarNota_Click(object sender, EventArgs e) 
( 

if (lPage.IsVvalid) return; 

// Obtener los datos de los controles del formulario 

int idAlum = Convert.Tolnt32(ctDni.Text); 
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int idAsig = Convert.Tolnt32(IsdAsignatura.Selectedltem.Value); 
// Crear el contexto de objetos 
using (bd_notasAlumnosContexto contexto0bjs = 
new bd_notasAlumnosContexto()) 
( 
// Consulta para obtener el nombre de idAlum y su nota en idAsig 
var consulta = from alum in contexto0bjs.alumnos 
from al_as in alum.alums_asigs 
where al_as.id_alumno == idAlum 24 
al_as.id_asignatura == idAsig 
select new { alum.nombre, al_as.nota }; 
try 
( 





// Ejecutar la consulta y obtener los datos 
if (consulta.Count() != 0) 
( 





foreach (var alum in consulta) 
( 
// Mostrar en la página el nombre y la nota 
etNombre.Text = "Nombre: " + alum.nombre; 
etNota.Text = "Nota: " + alum.nota; 
etError.Text = ""; 
) 
) 
else 
( 
// El alumno buscado no se encontró 
etNombre.Text = ""; 
etNota.Text = ""; 
etError.Text = "Error: no está en acta"; 
) 
) 
catch (Exception exc) 
( 
etError.Text = "Error: 
) 


+ exc.Message; 


La aplicación web está finalizada (puede obtenerla de la carpeta Cap16|Form- 
WebNotas del CD correspondiente al libro). 


Obtener acceso a la base de datos 


De forma predeterminada, y dependiendo de la versión de IIS que tenga en su sis- 
tema operativo Windows, las aplicaciones ASP.NET se ejecutan con la identidad 
de la cuenta NT AUTHORITY Servicio de Red, IIS APPPOOL DefaultAppPool u 
otra. Se trata de cuentas con unos privilegios específicos (no tienen permisos para 
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acceder a determinados recursos de la máquina), normalmente pocos, entre otras 
cosas, por seguridad. Véase también el apartado Convertir la aplicación en una 
aplicación web de IIS del capítulo ASP.NET. 


Así mismo, cada servicio de SQL Server, para poder iniciarse y ejecutarse, 
debe tener una cuenta de usuario que se configura durante la instalación. Las 
cuentas de inicio utilizadas para iniciar y ejecutar SQL Server pueden ser cuentas 
integradas del sistema (por ejemplo NT AUTHORITY WNetworkService, IIS APP- 
POOL DefaultAppPool, NT AUTHORITYISERVICIO LOCAL o NT AUTHO- 
RITYISYSTEM), cuentas de usuario local o cuentas de usuario de dominio. 














r a 
BE Administración de equipos elak 
Archivo Acción Ver Ayuda 

es ¿Es BESO. 


a ($) Administrador de configura + 











Nombre Estado Modo de inic... Iniciar sesión como Acciones 
El Servicios de SQL Sever | AEREA NS | servidos de SQL Server 4 
8. Configuración de red de | Eb Agente SQL Se... Detenido Otro (arranq... NT AUTHORITYANETWORKSERVICE pa Ñ 


2. Configuración de SQLN. _ [| SQL Server Bro... Detenido Otro (arrang... NT AUTHORITY\LOCALSERVICE 
.8 Configuración de red de| = 


2 Configuración de SQL N — 


4 n r 





Acciones adicionales > 





SQL Server (SQLEXPRESS) 4 


| 
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Por ejemplo, la cuenta Servicio de red (NetworkService) es una cuenta inte- 
grada especial parecida a una cuenta de usuario autenticado, con un mayor nivel 
de acceso a los recursos y objetos que los miembros del grupo usuarios. 


Entonces, la solución para poder acceder a bd_notasAlumnos pasa por dar 
permisos a este usuario para acceder a esa base de datos (la base de datos se cons- 
truyó bajo otro usuario de Windows, probablemente con el que se autenticó). Una 
forma de hacerlo es ejecutando el script mostrado en la figura siguiente desde la 
utilidad SOLCMD o desde MS SOL Server Management Express (de aquí en ade- 
lante me referiré al usuario Servicio de Red, pero, dependiendo de cómo configu- 
remos IIS, puede ser otro). 








- 
EN SQLCMD >2/B 


Microsoft Windows [Versión 6.1.7601] 
Copyright (c) 2009 Microsoft Corporation. Reservados todos los derechos. 





[m] > 


C:\Users\fjceballos>cd C:\Program Files\Microsoft SQL Server\110\Tools\Binn 


C:\Program Files\Microsoft SQL Server\110\Tools\Binn>sqlemd -S .\sqlexpress 
1> CREATE LOGIN [NT AUTHORITY\Seruvicio de Red] FROM WINDOWS 

2> USE bd_notasAlumnos 

3> CREATE USER [Servicio de Red] FROM LOGIN [NT AUTHORITY Servicio de Red] 
4> GRANT CONNECT TO [Servicio de Red] 

5> EXEC sp_addrolemember 'db_owner', 'Servicio de Red' 

G> GO 
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Este script lo que hace es lo siguiente: 


Crea un inicio de sesión a partir de una cuenta de dominio de Windows (nom- 
breDeDominiolnombreDelnicioDeSesión), en el ejemplo NT AUTHORITY!- 
Servicio de Red. Hay cuatro tipos de inicio de sesión: de SQL Server, de 
Windows, asignado a un certificado y asignado a una clave asimétrica. Esta 
primera línea puede omitirse si la entidad de seguridad de servidor NT 
AUTHORITY Servicio de Red ya existe. 

Crea un usuario (Servicio de Red) para la base de datos especificada (en nues- 
tro caso bd_notasAlumnos) correspondiente al inicio de sesión. 

Da permiso al usuario para acceder a la base de datos. 

Agrega el usuario Servicio de Red al rol de base de datos db_owner en la base 
de datos actual. Los miembros de la función db_owner pueden realizar todas 
las tareas de configuración y mantenimiento de la base de datos. 


Ejecute de nuevo la aplicación, pulsando las teclas CtrI+F'5 o también, ha- 


ciendo clic con el botón secundario del ratón sobre la página a mostrar (De- 
fault.aspx) y ejecutando Explorar con... del menú contextual que se visualiza, lo 
que le permitirá seleccionar el explorador a utilizar, o bien, de una forma más real, 
abriendo el explorador y escribiendo la dirección URL: 


http: //localhost/FormWebNotas/Default.aspx 





r 





¡2 http://localhost/Form 


| e Formulario web notas 











DNI: |1234567 








PROGRAMACION AVANZADA 

LAB. DE PROGRAMACION AVANZADA 
FUNDAMENTOS DE PROGRAMACION 

LAB. DE FUNDAMENTOS DE PROGRAMACION 
PROGRAMACION 


¿FUNDAMENTOS DE PROGRAMACION 

“PROGRAMACION AVANZADA (OPTATIVA) 
PROGRAMACION VISUAL 
PROGRAMACIÓN CONCURRENTE 























CONTROLES DE VALIDACIÓN 


En muchas ocasiones puede resultar necesario comprobar que los usuarios escri- 
ben información válida, con un formato correcto, o simplemente que no dejan un 
campo vacío. En el capítulo ASP.NET ya vimos cómo emplear ModelState y los 
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atributos de anotación para validar los datos de la petición. Otra forma sencilla de 
realizar esto es utilizando controles de validación. 


Utilizando controles de validación, ¿dónde se realiza la validación? Puede 
realizarse en el lado del cliente o en el lado del servidor. No obstante, hay razones 
poderosas para realizar la validación en el lado del cliente; por ejemplo, notificar 
inmediatamente al usuario que no llenó un campo requerido supone ahorrar el 
tiempo necesario para enviar esa información al servidor, que el servidor genere 
un mensaje para informar al usuario del problema, y que lo retorne al usuario. Los 
controles de validación en ASP.NET son inteligentes; ellos ejecutarán siempre 
que sea posible la validación en el lado del cliente (véase Controles de validación 
en el capítulo ASP.NET), lo cual exige que el cliente soporte javascript; si no fue- 
ra así, la validación se haría en el lado del servidor. 


Los controles de validación se pueden utilizar con cualquier control que se 
procese en un fichero .cs (fichero de clase), incluidos los controles de servidor 
web y HTML. Estos controles fueron expuestos de forma resumida en el capítulo 
titulado ASP.NET. 


Como ejemplo vamos a añadir a la aplicación anterior un control Required- 
FieldValidator para comprobar que el usuario no deja vacía la caja de texto 
ctDni, un control RangeValidator para comprobar que el DNI escrito está entre 
999999 y 99999999 (un control puede tener asociados varios controles de valida- 
ción) y un control ValidationSummary para mostrar los mensajes de error envia- 
dos por los controles de validación. El resultado sería el siguiente: 


Default.aspx.cs Defaultaspx + X - 








DNI: | ** » Mensaje de error 1. 
, e Mensaje de error 2. 
| Sin enlazar y 
Consultar nota 
Nombre: 
Nota: 
Error: 


Si está escribiendo la aplicación con Visual Studio, arrastre sobre el formula- 
rio web los nuevos controles que observa en la figura anterior y establezca las 
propiedades especificadas a continuación: 
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RequiredFieldValidator (1D) cvDni 
Control ToValidate ctDni 
ErrorMessage DNI requerido 
Text $ 
RangeValidator (ID) cvDniRango 


ControlTo Validate ctDni 
ErrorMessage Valor fuera de rango 
MaximumValue 99999999 
Minimum Value 999999 
x 





Si no está utilizando Visual Studio, edite el fichero Default.aspx y añada el 
código siguiente: 


<html> 
<head> 
<title>Formulario web notas</title> 
</head> 
<body> 


<asp:RequiredFieldValidator 
ids"evDni" stylle="z= index: 107; lefts 520px; 
position: absolute; TOP: 7/1px" runat="server" 
ErrorMessage="DNI requerido" ControlToValidate="ctDni">* 

</asp:RequiredFieldValidator> 

<asp:RangeValidator 
1d="cvDniRango" style="z-index: 108; left: 530px; 
position: absolute; TOP: 71px" runat="server" 
ErrorMessage="Valor fuera de rango" ControlToValidate="ctDni" 
MaximumValue="99999999" MinimumValue="999999" Type="Integer">* 

</asp:RangeValidator> 

<asp:ValidationSummary 
1d="cvMensajes" style="z-index: 109; left: 550px; 
position: absolute; TOP: 66px" runat="server"> 

</asp:ValidationSummary> 

</form> 
</body> 
</html> 























Finalmente, ejecute la aplicación y pruebe los resultados. ¿Se le muestra un 
error Unobtrusive ValidationMode de WebForms requiere un ScriptResourceMap- 
ping para '¡query"? De forma predeterminada, ASP.NET 4.5 (esta versión es la 
que se instala con Visual Studio 2012) modificó el proceso de validación de con- 
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troles en el lado del cliente. Ahora realiza la validación utilizando el modo de va- 
lidación discreto, esto es, con JavaScript, que pasa desapercibido gracias a 
jQuery, en lugar de enviar los scripts de versiones anteriores. Esto quiere decir 
que el código para la validación en el cliente se encuentra, en su mayoría, en un 
único archivo .js externo (se descarga cuando se llama a la página por primera 
vez), que hace que las páginas sean más pequeñas y más rápidas de cargar. Dicho 
de otra forma, con respecto a las versiones anteriores, ahora se puede separar el 
código de validación del código de marcado de la página web (análogo a separar 
la capa de presentación de la lógica de negocio). 


Entonces, este error se produce porque ahora la validación necesita la biblio- 
teca JavaScript jQuery que no está incluida en el proyecto. 


La solución pasa por implementar alguna de las opciones siguientes: 


p< 


Deshabilitar el modo de validación discreto a nivel de página. 
2. Deshabilitar el modo de validación discreto para toda la aplicación. 
3. Utilizar el modo de validación discreto. 


Deshabilitar el modo de validación discreto 


Deshabilitar el modo de validación discreto a nivel de página supone añadir la 
línea siguiente en el controlador del evento Load de la página para habilitar la va- 
lidación tradicional de las versiones anteriores a la versión 4.5 de ASP.NET: 


Page.UnobtrusiveValidationMode = 
System.Web.UI.UnobtrusiveValidationMode.None; 


y deshabilitar el modo de validación discreto para toda la aplicación supone agre- 
gar el siguiente código en la sección <appSettings> de Web.config: 


<appSettings> 
<add key="ValidationSettings:UnobtrusiveValidationMode" value="None"/> 
</appSettings> 


Ahora puede ejecutar la aplicación. Sería interesante que utilizara algún proxy 
de depuración web, como Fiddler, Firebug o Membrane, para que pueda registrar 
todo el tráfico HTTP entre nuestro ordenador y el servidor con el fin de que su- 
pervise los scripts de validación en el lado del cliente y pueda comparar con el 
modo de validación discreto que exponemos a continuación. 


Modo de validación discreto 


El modo de validación discreto requiere de la biblioteca jQuery. Por lo tanto, 
lo primero que hay que hacer es, utilizando el administrador NuGet, añadir esta 
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biblioteca al proyecto. También es necesario añadir al proyecto un nuevo elemen- 
to de tipo Clase de aplicación global, esto es, el fichero Global.asax, para poder 
crear en el controlador del evento Start del objeto Application un ScriptResour- 
ceDefinition con nombre jquery que haga referencia a la ubicación de la biblioteca 
¡Query (modifique el número de versión si fuera necesario): 


void Application_Start(object sender, EventArgs e) 
( 
ScriptManager.ScriptResourceMapping.AddDefinition("jquery", 
new 
( 
Path = "-/scripts/jquery-2.0.2.min.js"”, 
DebugPath = "-/scripts/jquery-2.0.2.js", 
CdnPath = "http://ajax.aspnetedn.com/ajax/jQuery/jquery-2.0.2.min.js", 
CdnDebugPath = "http: //ajax.aspnetedn.com/ajax/jQuery/jquery-2.0.2.js" 


Este objeto ScriptResourceDefinition de nombre ¡query define la ruta donde 
se localizan los scripts requeridos por los controles de validación para la valida- 
ción en el lado del cliente. Se indica la ruta de las versiones de producción y de 
depuración, tanto localmente como en un CDN (Content Delivery Network) ges- 
tionado por Microsoft, para el caso de que fueran necesarias. 


Evidentemente, utilizar el modo de validación discreto es la mejor opción. 
Compruébelo volviendo a ejecutar la aplicación y utilizando algún proxy de depu- 
ración web, verifique que ahora el tráfico es mucho menor. Sepa que cuando se 
crea un proyecto web partiendo de la plantilla Sitio de ASP.NET Web Forms, por 
defecto se instala ¡Query y se añade el fichero Global.asax. 


El archivo Global.asax, también conocido como “archivo de aplicación de 
ASP.NET”, es opcional y contiene el código para responder a los eventos del ni- 
vel de aplicación y de sesión provocados por ASP.NET o por módulos HTTP. Re- 
side en el directorio raíz y se compila en una clase de .NET Framework que 
deriva de la clase base HttpApplication. No se puede solicitar su ejecución direc- 
tamente (por medio de una URL) y no se puede descargar ni ver el código que 
contiene. 


HERRAMIENTA DE PRECOMPILACIÓN ASP.NET 


Si no quiere facilitar los ficheros fuente de su aplicación ASP.NET, deberá crear 
una versión ejecutable de todo el sitio web, sin ningún fichero de código fuente, 
incluidos los ficheros HTML. El resultado, ensamblados y ficheros auxiliares po- 
drán ser publicados en un servidor a través de XCOPY, FTP, explorador de Win- 
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dows, etc. Además, evitamos que la primera petición de una página .aspx sea muy 
lenta, ya que su compilación ocurre en la primera petición. 


Cuando se compila una página después de la primera petición, el resultado se 
guarda en el directorio Temporary ASP.NET Files de c.lwindowsMicrosoft.NET!- 
Frameworklversión. 


Para realizar esta precompilación, ASP.NET proporciona la utilidad asp- 
net_compiler localizada en Windows|Microsoft.NET|Frameworklversión cuya 
sintaxis abreviada es la siguiente: 


aspnet_compiler /v /sitio_web -p ruta_origen ruta_destino 


donde sitio_web es el nombre del sitio web, ruta origen es la ruta donde se loca- 
liza el sitio web (la aplicación ASP.NET) y ruta destino la ruta donde se desea 
ubicar la versión precompilada, la cual se puede corresponder con un directorio 
cualquiera del sistema de ficheros o con un directorio del sitio web localizado en 
...Unetpublwwwroo!t. 


Una vez ejecutada la orden podrá observar que el sitio web resultante contie- 
ne un directorio bin con varios ensamblados y ficheros descriptivos, así como va- 
rios ficheros auxiliares con los mismos nombres que las páginas originales, pero 
sin código. 


Por ejemplo, suponiendo que la aplicación ASP.NET anteriormente desarro- 
llada está ubicada en el directorio c:leslFormWebNotas, este proceso requiere eje- 
cutar los siguientes pasos: 


1. Abrir una ventana tipo consola del sistema desde la que se pueda ejecutar la 
utilidad aspnet_compiler. 


2. Precompilar la aplicación ASP.NET c.leslFormWebNotas: 


C:l>»aspnet_compiler /v /FormWebNotas -p c:\cs\FormWebNotas 
c:1InetpublwwwrootiFormWebNotas 


3. Crear una aplicación de IIS, en el sitio web ...l/netpublwwwroot, del directo- 
rio donde se encuentra la aplicación precompilada. 


En el ejemplo realizado, el sitio web se ha denominado FormWebNotas y el 
resultado de la precompilación se ha almacenado en el directorio FormWebNotas 
del sitio web predeterminado (c:l/netpublwwwroot). Finalmente, hemos creado en 
el sitio web predeterminado una aplicación de IIS de nuestro sitio web, denomi- 
nada también FormWebNotas. 
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PROCESAMIENTO DE FORMULARIOS 


Hemos visto que los clientes web pueden mostrar formularios para solicitar datos 
a los usuarios y ser enviados al servidor para, por ejemplo, obtener datos de una 
base de datos y dar al usuario una respuesta ajustada a la petición, o bien para rea- 
lizar cualquier otro proceso. 


Según lo estudiado hasta ahora, el código HTML que da lugar a un formulario 
está estructurado así: 


<html xmlIns="http://www.w3.org/1999/xhtml" > 
<head runat="server"> 
<title>Untitled Page</title> 
</head> 
<body> 
<form id="forml" runat="server" method="post"> 


</form> 
</body> 
</html> 


Observamos que la etiqueta form que define el formulario encierra al resto de 
etiquetas que dan lugar al mismo. Su atributo method, opcional, indica la forma 
en la que los datos del formulario serán enviados; los valores posibles son get y 
post. Cuando method se omite su valor es post. Explicaremos esto con más deta- 
lle a continuación. 


Formato de la petición HTTP 


La petición está formada por la línea de la petición, más la cabecera y el cuerpo de 
la petición, en este orden. 


La línea de la petición contiene los siguientes elementos: nombre del método 
HTTP utilizado (GET, POST, etc.), identificador del recurso (URL) que se solici- 
ta, más los parámetros si los hay, y la versión del protocolo utilizado. Por ejemplo: 


GET http: //servidor/MiApp/Default.aspx?ctNombre=JaviergbtEnviar=Enviar HTTP/1.1 


POST http: //servidor/MiApp/Default.aspx HTTP/1.1 


La cabecera de la petición contiene la información adicional sobre el cliente 
que hace la solicitud. Los identificadores más importantes son Host, nombre del 
servidor; User-Agent, nombre del navegador o del programa usado para acceder al 
recurso solicitado; Accept, formatos de texto e imagen aceptados por el User- 
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Agent; o Accept-Language, idiomas que soporta (preferentemente) el cliente. Por 
ejemplo: 


Host: servidor 

User-Agent: Mozilla/5.0 (Windows; U; Windows NT 6.0; es-ES; rv:...) 
Accept: text/html, application/xhtml+xml,application/xml;q=0.9,.. 
Accept-Language: es-es,es;q=0.8,en-us;q=0.5,en;q=0.3 
Accept-Encoding: gzip,deflate 

Accept-Charset: IS0-8859-1,utf-8;q=0.7,*;q=0.7 

Keep-Alive: 115 

Connection: keep-alive 

Referer: http://servidor/cs/Default.aspx 


El cuerpo de la petición, en peticiones de tipo POST y otras, contiene más in- 
formación adicional. Por ejemplo: 


ctNombre=Javier&btEnviar=Enviar 


Cuando la URL escrita en el navegador corresponde a un formulario de una 
aplicación ASP.NET, la petición inicial (para descargar la página inicial) utiliza el 
método GET, y las siguientes, cuando el formulario es reenviado al servidor, utili- 
zan el método POST. 


Petición HTTP get 


Cuando el tipo de petición HTTP es get, los datos del formulario son enviados al 
servidor a continuación de la dirección URL. Por ejemplo, supongamos que he- 
mos diseñado un formulario como el que se muestra a continuación, indicando 
explicitamente que sus datos serán enviados utilizando el método get: 











a 





=| 





A 
O E http://localhost/Estado/Def: O ~ E O || Æ localhost 


Nombre: [Francisco Javier Ceballos Enviar | 
































K y 





Cuando el usuario haga clic en el botón Enviar de este formulario, el navega- 
dor abrirá una conexión HTTP con la máquina localhost (en el caso de una má- 
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quina remota, por ejemplo, www. microsoft.com, el nombre del servidor se resuel- 
ve a través del DNS) y enviará una petición con la siguiente información (supo- 
niendo que se han introducido los datos indicados): 


http: //localhost/Estado/Default.aspx?_VIEWSTATE=hupIbSyf5SRpNxV%2B 
dH9IpPF6EVOGUWP8T0uuUbqsC6aqlGwlyIktQXyU0caZkyeG76%2FSpbU0arrzSWbMimP 
3jq6eWf4p0IL%2FXJEyr3m75111Y%3D8-EVENTVALIDATION=0%2B17MYpa5Lnrbku 
JuK9yBxJ3MUNHuHa6SJxG4ejRPv%2F3mMbWqd1D83AUMWq57Xwtaf13p72M%2BD%2BH 
j%2FbLyzBAkycxNCONDANTAOL4jGDHWANR%2BT%2BYIDEKAJBPpAOVqv3yGjirMTAmzni% 
2BG02%2BkUJjPKSQW23D%3D8CENOMbre=Francisco+Javier+CeballosgbtEnviar 
=Enviar 


A continuación de la URL podremos observar los parámetros VIEWSTATE, 
_ EVENTVALIDATION, ctNombre y btEnviar colocados después del símbolo ? y 
separados por el símbolo &. Los parámetros y sus valores están compuestos por 
caracteres ASCII alfanuméricos más los caracteres . (punto), - (guión), * (asteris- 
co) y _ (subrayado); los espacios en blanco son sustituidos por + y otros caracte- 
res como las letras acentuadas por %dd (dd: código en hexadecimal del carácter). 


Resumiendo, con el tipo de petición HTTP get la información del formulario 
se envía añadiéndola a la URL, el tamaño de la cadena enviada está limitado y al 
estar en ASCII es totalmente legible; por lo tanto, no es un modo seguro, ya que 
puede ser utilizada malintencionadamente como destino de un enlace. 


Un poco más adelante estudiaremos que ASP.NET mantiene el estado de un 
formulario a través de su propiedad ViewState, heredada de la clase Sys- 
tem.Web.UI.Control, de ahí el parámetro VIEWSTATE. 


Petición HTTP post 


Cuando el tipo de petición HTTP es post, los datos son enviados al servidor en el 
cuerpo de la petición, es el método usual de enviar los datos de un formulario, y el 
tamaño de la información enviada no está limitado. Por ejemplo: 


POST /Estado/Default.aspx HTTP/1.1 

Accept: text/html, application/xhtml+xml, */* 
Referer: http://localhost/Estado/Default.aspx 
Accept-Language: es-ES 
User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 6.1; 
0W64; Trident/6.0) 
Content-Type: application/x-www-form-urlencoded 
Accept-Encoding: gzip, deflate 
Host: localhost:80 
Content-Length: 372 

DNT: 1 

Connection: Keep-Alive 
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Cache-Control: no-cache 
X-Forwarded-For: 0:0:0:0:0:0:0:1 







=hupIbSyf5SRpNxV%2BdH9IPpPFEVOGUWP8TO0uuUbqsC6aqlGwIyIktQ 
XyU0ca/kyeG76%2FSpbU0arrzSWbMimP3jq6eWf4p0IL%2FXJEyr3m75111Y%3D 

& =0%2BI7MYpa5LnrbkuJuK9yBxJ3MUhHuHa6SJxG4ejRPv 
%2F3mMbWqd1D83AUMWq57Xwtaf13p72M%2BD%2BHj%2FbLyzBAkycxNC6nD4NIA 
oL4jDHWhR%2BT%2BYJDtKAJBpAOVqv3yGjirMTAmzni%2BG02%2BkUJjPKSQw%3D 


%3D4CtNombre=Francisco+Javier+Ceballos&btEnviar=Enviar 


Según lo expuesto, elegir el método para enviar la información no es difícil. 
Si los datos son pocos y no importa su confidencialidad o manipulación, podre- 
mos utilizar get. Si son largos, privados o importantes, no lo dudaremos, post. 








Respuestas en el protocolo HTTP 


Las respuestas en el protocolo HTTP son similares a las peticiones. Una respuesta 
estándar sería similar a la siguiente: 


HTTP/1.1 200 OK 

Cache-Control: private 

Content-Type: text/html; charset=utf-8 
Server: Microsoft-11S/7.5 
X-AspNet-Version: 4.0.30319 
X-Powered-By: ASP.NET 

Date: Thu, 14 Nov 2013 08:45:28 GMT 
Content-Length: 1017 


<html> 
<html> 

La primera línea indica la versión del protocolo utilizada para enviar la pági- 
na, seguida por un código de retorno y lo que se denomina una frase de retorno. 
Después del estado aparecen unos campos de control, que tienen el mismo forma- 


to que los que aparecen en las cabeceras de la petición y a continuación se incluye 
el contenido del recurso solicitado. 


Contexto de un formulario web 


Como ya vimos anteriormente en este capítulo, un formulario web está formado 
por, al menos, dos ficheros con extensiones .aspx y .cs, en nuestro caso. El fichero 
.aspx, conocido como página web, almacena los elementos visuales, esto es, la in- 
terfaz gráfica de usuario. El fichero .cs, conocido como fichero de código subya- 
cente, almacena una clase derivada de System.Web.Ul.Page que define la lógica 
de la interfaz de usuario a través de las propiedades y de los métodos que dan so- 
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porte a la página. Aparte de esta clase base, de los controles HTML y de los con- 
troles de servidor web que facilitan el diseño de los formularios web, ASP.NET 
proporciona otro conjunto de objetos en el espacio de nombres System.Web que 
permiten la interacción entre el cliente y el servidor en una aplicación web; los 
más importantes se describen a continuación: 


e HttpContext. Define el contexto en el que se atiende la petición. 


nombre = HttpContext.Current.Request.Params["ctNombre"]; 


e Request. Define la petición HTTP realizada por el cliente. 


etVisitas.Text = "Hola " + this.Request.Params["ctNombre"]; 


e Response. Define la respuesta HTTP devuelta por el servidor. 


this.Response.Write("La página requerida no se puede visitar"); 


e Server. Proporciona métodos para ayudar a procesar peticiones web. 
string sError = "No hay errores.”"; 


if (Server.GetlastError() != null) 

( 
sError = Server.GetLastError().Message; 
Server.ClearError(); 


) 


string sUrl = Request.Url.ToString(); 

string sMensaje = "<font face=verdana color=blue>" + 
"<h4>" + Server.HtmlEncode(sUrl) + "</h4>" + 
"<font color=*red*>" + sError + "</font>"; 

Response.Write(sMensaje); 

// 

string sRutaSitioWeb = Server.MapPath("=/"); 

fi 








La propiedad Page.Server hace referencia a un objeto de la clase HttpSer- 
verUtility que proporciona métodos auxiliares para procesar las solicitudes 
web. El código anterior muestra varios ejemplos. Por ejemplo, MapPath con 
el argumento especificado devuelve la ruta de acceso física del sitio web. 


e Session. Define variables globales a nivel de una sesión de usuario; esto es, 
variables comunes a todas las solicitudes de un cliente concreto. 


string id = this.Session["id"]; 
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e Application. Define variables globales a nivel de la aplicación; esto es, varia- 
bles comunes a todas las solicitudes recibidas desde cualquier cliente. 


string cuenta = this.Application["cuenta"]; 


Mientras que HttpContext, Request y Response proporcionan el contexto de 
una solicitud concreta, Session y Application proporcionan un mecanismo senci- 
llo para almacenar información acerca del estado de una aplicación web, a nivel 
de cada usuario y a nivel global, respectivamente. 


Redireccionar una solicitud a otra URL 


Para redireccionar una solicitud a una nueva URL, simplemente hay que invocar 
al método Redirect del objeto Response de la clase HttpResponse: 


Response.Redirect("http://www.microsoft.com"); 


Response.Redirect("Bienvenida.aspx"); 


ESTADO DE UNA PÁGINA ASP.NET 


HTTP es un protocolo sin estado; esto es, cada petición es tratada de forma inde- 
pendiente por el servidor. Esto es así porque las páginas web se vuelven a crear 
cada vez que la página se envía al servidor, lo que se traduce en que toda la in- 
formación asociada a la página y a los controles de la misma se pierde con cada 
recorrido de ida y vuelta. Por lo tanto, el servidor no sabe si una serie de peticio- 
nes provienen del mismo o de diferentes clientes web y si, además, están relacio- 
nadas entre sí. Esto presenta un sinfín de problemas para determinadas 
aplicaciones. Por ejemplo, cuando estemos haciendo una compra a través de una 
página web y añadamos uno y otro artículo a nuestro carrito, entre petición y peti- 
ción, ¿cómo recordará el servidor lo que hemos comprado? ¿Cómo identificará mi 
compra de la de otro cliente? Igualmente, cuando realicemos otra petición, por 
ejemplo, al servicio que nos permite dar nuestro número de tarjeta de crédito y la 
dirección de envío, ¿cómo recordará el servidor lo que hemos comprado? 


Para superar esta limitación inherente a la programación web tradicional, 
ASP.NET incluye diversas opciones para administrar el estado de una página. Por 
ejemplo, incluye un servicio denominado estado de vista, que conserva automáti- 
camente los valores de las propiedades de la página y de todos sus controles entre 
un recorrido de ida y vuelta y otro. Otras opciones, como una cookie o un campo 
oculto en una página, nos permitirán guardar valores específicos de la aplicación. 
Algunas opciones mantienen la información en el cliente y otras en el servidor, 
según veremos a continuación. 
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Administración de estado en el cliente 


Las opciones cookies, cadenas de consulta, campos de formulario ocultos y esta- 
do de la vista almacenan la información de estado en la página o en el equipo 
cliente; esto es, no se conserva en el servidor entre acciones de ida y vuelta. 


Cookies 


Una cookie es una pequeña cantidad de información (no más de 4 K) que una 
aplicación web puede crear y almacenar en la máquina cliente y, posteriormente, 
consultar a través de la API de cookies de ASP.NET. 


Las cookies son una de las soluciones más utilizadas para realizar el segui- 
miento de una sesión. Utilizando este mecanismo, el servidor web envía una coo- 
kie al cliente (por ejemplo, con un identificador de sesión), la cual será retornada 
sin modificar por el cliente automáticamente por cada nueva petición que este ha- 
ga al servidor, asociando la petición del servicio de modo inequívoco con una se- 
sión. 


En el caso del carrito de la compra, podemos utilizar cookies para almacenar 
el identificador del cliente para poder identificar en el servidor los artículos com- 
prados por este; de esta forma, cada petición subsiguiente podrá obtener informa- 
ción de la anterior. Ésta es una excelente alternativa, pero, a pesar de que 
ASP.NET proporciona la clase HttpCookie del espacio de nombres System.Web 
para que podamos trabajar con cookies, existen ciertos aspectos que deben ser 
controlados y que no resultan sencillos: 


e Extraer la cookie que almacena el identificador de sesión entre todas las co- 
okies, ya que puede haber varias. 

e Seleccionar un tiempo de expiración apropiado para la cookie. 

e Asociar la información del servidor con el identificador de sesión (cierta in- 
formación que puede ser peligrosamente manipulada, como los números de 
las tarjetas de crédito, nunca debe almacenarse en cookies). 


Una cookie se compone de dos partes: un nombre y un valor; el nombre la 
identifica entre todas las demás cookies almacenadas en el cliente y el valor es un 
dato asociado con la cookie. 


Una aplicación para crear una cookie simplemente tiene que invocar al cons- 
tructor de la clase HttpCookie pasando como argumentos su nombre y, opcio- 
nalmente, el valor asociado: 


HttpCookie miCookie = new HttpCookie("nombre", "valor"); 
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Una vez creada una cookie en el servidor, debe añadirse a las cabeceras de la 
respuesta HTTP para que sea enviada al cliente. Para ello, hay que invocar al mé- 
todo Add de la colección Cookies de HttpResponse pasando como argumento la 
cookie que se desea añadir: 


Response.Cookies.Add(miCookie); 


El método Add de Cookies no afecta a las cookies que ya existan en el clien- 
te. El tamaño de una cookie está limitado a 4 Kb y la mayoría de los exploradores 
limitan el espacio total de almacenamiento a 2 Mb, por lo que este método puede 
hacer que se eliminen otras cookies. La fecha de expiración de una cookie es solo 
una sugerencia; es el explorador el que decide cuándo eliminar las cookies depen- 
diendo del espacio de almacenamiento. 


Por otra parte, la colección Cookies de HttpRequest contiene las cookies 
transmitidas por el cliente al servidor en el encabezado HTTP. Entonces, para leer 
una cookie, hay que acceder a esa colección y localizarla. El siguiente ejemplo re- 
corre la colección de cookies enviadas por el cliente, y envía el nombre, el valor, 
la fecha de caducidad y el parámetro de seguridad, a la salida HTTP: 


private HttpCookie unaCookie = null; 
11 
for (int i = 0; i < this.Request.Cookies.Count; i++) 


{ 
unaCookie = this.Request.Cookies[i]; 








Response.Write("Nombre: " + unaCookie.Name + "<br>"); 
Response.Write("Valor: " + unaCookie.Value + "<br>"); 
Response.Write("Expira: " + unaCookie.Expires + "<br>"); 
Response.Write("Seguridad: " + unaCookie.Secure + "<br>"); 


Cuando un cliente realiza una petición a un servidor, envía las cookies propias 
de ese servidor, no todas. Las cookies que un cliente almacena para un servidor 
solo pueden ser devueltas a ese mismo servidor. Por lo tanto, las aplicaciones que 
se ejecutan dentro de un servidor comparten las cookies. 


El siguiente ejemplo muestra una página que escribe una cookie para llevar la 
cuenta del número de veces que es accedida: 


public partial class _Default : System.Web.UlI.Page 
( 
private HttpCookie unaClookie; 
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protected void Page_lLoad(object sender, EventArgs e) 

( 
// Obtener el valor actual de la cookie "cuenta" buscando 
// entre las cookies recibidas. 
unaCookie = null; 


for (int i = 0; i <= this.Request.Cookies.Count - 1; i++) 
{ 
unaCookie = this.Request.Cookies[i]; 
if (unaCookie.Name == "cuenta") break; 
) 
) 


protected void btEnviar_Click(object sender, EventArgs e) 
( 
// Incrementar el contador para esta página. El valor es 
// guardado en la cookie con el nombre "cuenta". 
// Después, asegurarse de enviársela al cliente con la 
// respuesta (Response). 
if (unaCookie == null) 
( 
// Si no se encontró 
unalookie = new HttpCookie("cuenta", "1"); 
1 
$ 
else 
{ 
// Si se encontró 
unaCookie.Value = 
Convert.ToString(Convert.ToInt32(unaCookie.Value) + 1); 
) 
this.Response.Cookies.Add(unaClookie); 


// Mostrar el resultado en la página 
etVisitas.Text = ctNombre.Text + 


" has visitado esta página + unaCookie.Value; 





) 


1 
ij 


Cadenas de consulta 


Una cadena de consulta es información que se anexa al final de la dirección URL 
de una página. También se denomina “reescritura de la URL”. Un ejemplo lo vi- 
mos al hablar del tipo de petición HTTP get: 


http://localhost/Estado/Default.aspx 
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En la ruta URL del ejemplo, la cadena de consulta empieza con un signo de 
interrogación (?) e incluye tres parejas atributo-valor: una de ellas denominada 
“ VIEWSTATE”, otra denominada “ctNombre” y la otra denominada “btEn- 
viar”. 


Las cadenas de consulta proporcionan una manera sencilla pero limitada para 
mantener cierta información de estado, porque en la mayoría de los exploradores 
y dispositivos de cliente la longitud de la dirección URL tiene una limitación de 
255 caracteres. Como ya estudiamos anteriormente, para que los valores de las 
cadenas de consulta estén disponibles durante el procesamiento de la página, debe 
enviar la página utilizando el método get de HTTP. 


Campos de formulario ocultos 


Un parámetro oculto es un control de entrada de tipo hidden. En este caso no se 
muestra ningún campo de entrada de datos al usuario, pero el par variable-valor 
especificado es enviado junto con el formulario. 


<input type="hidden" name="variable" value="valor"> 


Se suelen utilizar para mantener datos durante una sesión. Inconveniente, que 
se puede ver la información si se obtiene acceso al código fuente de la página di- 
rectamente, lo que supone un problema de seguridad, aunque puede cifrar y desci- 
frar el contenido de un campo oculto de forma manual, pero esto requiere una 
codificación y una sobrecarga adicionales. Por lo tanto, no almacene ninguna in- 
formación que sea confidencial en un campo oculto sin cifrar, ya que es fácil que 
un usuario malicioso vea y modifique el contenido del mismo. 


Cuando se envía una página al servidor, el contenido del campo oculto se en- 
vía en la colección Form de HTTP junto con los valores de otros controles, de ahí 
que para que los valores de los campos ocultos estén disponibles durante el proce- 
samiento de la página, debe enviar la página utilizando el método post de HTTP. 
Un campo oculto actúa como un repositorio de cualquier información especifica 
que desee almacenar directamente en la página. 


ASP.NET ofrece el control HtmlInputHidden, que nos da soporte para el 
manejo de campos ocultos. 


Estado de vista 


Se conoce como estado de vista al método que utiliza una página web ASP.NET 
para conservar los valores de sus propiedades y de las propiedades de sus contro- 
les, entre los recorridos de ida y vuelta que se producen cuando se solicita la mis- 
ma repetidas veces. También se pueden almacenar parejas atributo-valor. Para 
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guardar este estado se utiliza la propiedad ViewState que los controles heredan de 
la clase Control del espacio de nombres System.Web.UI. Esta propiedad propor- 
ciona un diccionario (un objeto colección) para conservar valores entre las distin- 
tas peticiones de una misma página. 


Internamente, el estado de vista se define mediante un campo oculto incluido 
en el formulario HTML correspondiente a la página. Este campo oculto, denomi- 
nado _ VIEWSTATE, es añadido por el servidor a cada formulario que especifi- 
que el atributo runat="server”. De esta forma, es la página web la que se 
encarga, de forma transparente al usuario, de mantener su estado que será actuali- 
zado en el servidor. La página genera este campo durante la generación del 
HTML, es decir, en el último momento posible en el que la información está dis- 
ponible. Esto lo podemos comprobar fácilmente si visualizamos el código fuente 
de la página HTML que se muestra en el explorador web de la máquina cliente. 
En él podemos ver algo así: 


<input type="hidden" name="__VIEWSTATE" id="__VIEWSTATE” value="/w 
EPDwULLTE1MZI4NTE1OTYPFgleBmN1ZW50YQUCMTUWAgIDD20WBAITHDw8WAh4EVGV4d 
AURQm11bnZ1bmlkbyBKYXZpZXJkZAI - 
JDw8WAh8BBSpWaXNpdGFzIGEgZXNOYSBww6FnaW5hIGVuIGVzdGEgc2VzacOzbjogMT 
VkZGSvWLBUDBJdwwWSRcw0Q7XeyEkEvbw=="/> 


El valor de VIEWSTATE representa el estado de la página la última vez que 
se procesó en el servidor y, aunque se envía al cliente, no contiene ninguna infor- 
mación que deba utilizar el cliente. La información que se almacena en el estado 
de vista solo concierne a la página y a algunos de sus controles secundarios, y la 
lee, utiliza y modifica exclusivamente el servidor. 


El siguiente ejemplo muestra una página que utiliza su propiedad ViewState 
para llevar la cuenta del número de veces que es accedida: 






































a [a] 
O 8 ht /Aocalhost/Estado/Def: P ~ E © || 8 localhost | w 
Nombre: [Javier | Enviar | 
Bienvenido Javier 
Visitas a esta página en esta sesión: 15 
pa A 





public partial class _Default : System.Web.UI.Page 
( 
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protected void Page_lLoad(object sender, EventArgs e) 
( 
if (!Ithis.IsPostBack) 
if (this.ViewState.Count == 0) 
this.ViewState["cuenta"] = "0"; 


) 





protected void btEnviar_Click(object sender, EventArgs e) 


( 








etMensaje.Text = "Bienvenido " + ctNombre.Text; 

this.ViewState["cuenta"] = Convert.ToString(í 
Convert.Tolnt32(this.ViewState["cuenta"]) + 1); 

etVisitas.Text = "Visitas a esta página en esta sesión: " + 





this.ViewState["cuenta"]; 


Otro campo oculto que el servidor añade a la página es EVENTVALIDA- 
TION. Este campo es una medida de seguridad de ASP.NET para evitar que usua- 
rios potencialmente maliciosos envíen solicitudes no autorizadas desde el cliente. 
Así, para garantizar que todos y cada uno de los eventos se originan en los ele- 
mentos esperados de la interfaz de usuario, la página incluye un nivel adicional de 
validación de eventos. La página genera este campo cuando genera el estado de la 
vista, registrando, por ejemplo, los eventos que se pueden generar y en base a qué 
elemento se generan (por ejemplo, una lista si tiene tres elementos no puede gene- 
rar un evento en base a un cuarto elemento; si esto sucediera, alguien malinten- 
cionadamente añadió en el cliente ese cuarto elemento, utilizando, por ejemplo, 
JavaScript). Para detectar este tipo de solicitudes no autorizadas, básicamente, la 
página hace coincidir el contenido de la solicitud con la información del campo 
_ EVENTVALIDATION para comprobar que no se ha agregado un campo de en- 
trada adicional en el cliente. 


Si recuerda lo explicado relativo al ciclo de vida de una página web, cuando 
se devuelve la página al servidor, la clase de página generada dinámicamente uti- 
liza los datos almacenados en el estado de vista para recrear el último estado co- 
rrecto conocido para los controles de la página, y después se procesan los eventos 
en el orden en que se generan. Piense qué ocurriría si se manipulara el estado de 
vista o la validación de eventos en el cliente. Por eso, ambos campos ocultos se 
codifican con el esquema Base64 y se les aplica un algoritmo hash en base a una 
clave de servidor; el valor hash resultante se almacena también con el estado de 
vista. Cuando se devuelve la página, se vuelve a hacer el cálculo y se verifica si 
los dos valores hash coinciden; si no coinciden se produce una excepción de segu- 
ridad. 
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Administración de estado en el servidor 


ASP.NET ofrece distintas maneras de conservar la información de estado en el 
servidor. Estas son las siguientes: estado de aplicación, estado de sesión y bases 
de datos. 


Estado de aplicación 


El estado de aplicación es un mecanismo de almacenamiento general accesible 
desde todas las páginas de la aplicación web, por lo que es útil para el almacena- 
miento de información que deba conservarse entre recorridos de ida y vuelta del 
servidor y de una página a otra. Este estado está definido para cada aplicación 
web activa por un objeto Application de la clase HttpApplicationState. Se trata 
de un diccionario con elementos clave-valor que se crea cuando se resuelve una 
URL específica. Igual que ocurría con la propiedad ViewState, puede agregar in- 
formación específica de la aplicación a esta estructura para almacenarla entre las 
peticiones de página. 


El ejercicio expuesto anteriormente puede escribirse también así: 


protected void Page_load(object sender, EventArgs e) 
( 
if (Ithis.IsPostBack) 
if (this.Application.Count == 0) 
this.Application["cuenta"] = "0"; 


} 





protected void btEnviar_Click(object sender, EventArgs e) 
( 


etMensaje.Text = "Bienvenido " + ctNombre.Text; 


this.Application["cuenta"] = Convert.ToString( 
Convert.Tolnt32(this.Application["cuenta"]) + 1); 
etVisitas.Text = "Visitas a esta página: " + 
this.Application["cuenta"]; 





Los atributos fijados a través del objeto Application tienen ámbito de aplica- 
ción; esto quiere decir que son visibles por todos los componentes de la capa web 
durante todo el período de vida de la aplicación. Esto es, si la aplicación se des- 
instala o se reinicia, los atributos se pierden. Por eso, ahora el valor de la cuenta 
continúa de una sesión a otra; esto es, no se reinicia en cada sesión. 
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Estado de sesión 


El estado de sesión es similar al estado de aplicación, con la diferencia de que el 
ámbito es la actual sesión del explorador. Si hay distintos usuarios utilizando la 
aplicación, cada uno de ellos tendrá un estado de sesión distinto. Así mismo, si el 
mismo usuario deja la aplicación y vuelve más tarde, el usuario tendrá también un 
estado de sesión distinto. 


Este estado está definido para cada sesión de una aplicación web activa por un 
objeto Session de la clase HttpSessionState. Se trata de un diccionario con ele- 
mentos clave-valor que se crea cuando se resuelve una URL especifica. Igual que 
ocurría con la propiedad ViewState, puede agregar información específica de la 
aplicación a esta estructura para almacenarla entre las peticiones de página. 


El ejercicio expuesto anteriormente puede escribirse también así: 


protected void Page_load(object sender, EventArgs e) 
( 
if (Ithis.IsPostBack) 
if (this.Session.Count == 0) 
this.Session["cuenta"] = "0"; 


} 





protected void btEnviar_Click(object sender, EventArgs e) 
{ 
etMensaje.Text = "Bienvenido " + ctNombre.Text; 
this.Session["cuenta"] = Convert.ToString( 
Convert.ToInt32(this.Session["cuenta"]) + 1); 
etVisitas.Text = "Visitas a esta página en esta sesión: " + 
this.Session["cuenta"]; 





Los atributos fijados a través del objeto Session tienen ámbito de sesión; esto 
quiere decir que son visibles solo por el cliente HTTP que inició la sesión, para 
múltiples peticiones y hasta que la sesión finalice. Esto es, si la sesión finaliza au- 
tomáticamente porque transcurrió el tiempo fijado por el servidor, si es cancelada 
manualmente, o si la aplicación se desinstala o se reinicia, los atributos se pierden. 


Bases de datos 


El almacenamiento del estado de una aplicación en bases de datos es especialmen- 
te útil para almacenar una gran cantidad de información específica del usuario y 
conservarla a largo plazo, o para conservarla aun en el caso de que se deba reini- 
ciar el servidor. 
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El enfoque mediante bases de datos se suele utilizar en combinación con las 
cookies. Por ejemplo, cuando un usuario acceda por primera vez a la aplicación e 
inicie una sesión, la aplicación puede obtener de una cookie el identificador del 
usuario y buscar la información del mismo en una base de datos. 


MEJORANDO EL RENDIMIENTO EN EL SERVIDOR 


En ocasiones, cuando pasamos una aplicación ASP.NET a producción, nos encon- 
tramos con el siguiente problema: para un número de peticiones que consideramos 
normal para nuestra aplicación, el rendimiento del servidor se viene abajo; esto es, 
el sitio no aguanta un número moderado de peticiones concurrentes. Entre las mu- 
chas medidas que podemos aplicar para mejorar el rendimiento del servidor, va- 
mos a comentar dos: hacer uso de la caché del servidor y reducir la información 
de ida y vuelta entre el cliente y el servidor. 


También, no olvide poner a valor false el atributo debug del elemento compi- 
lation en el fichero win.config. 


<compilation debug="false"/> 


Almacenamiento en la caché de resultados 


El rendimiento de una aplicación en un servidor web es tanto mejor cuantas más 
solicitudes individuales pueda atender y esto está estrechamente ligado con la re- 
ducción del volumen de procesamiento que debe realizar para tal fin. Pues bien, 
una forma de conseguir un mejor rendimiento con ASP.NET consiste en almace- 
nar los resultados en la caché para reducir la carga de trabajo del servidor, lo cual 
reducirá su tiempo de respuesta. 


Según hemos estudiado anteriormente, cuando un explorador solicita una pá- 
gina web, ASP.NET crea un ejemplar de la página, ejecuta el código de la misma, 
ejecuta las consultas a la base de datos, si las hay, ensambla la página dinámica- 
mente y después envía el resultado al explorador. El almacenamiento de los resul- 
tados en caché (véase el apartado Modelo de ejecución de una página web 
ASP.NET en el capítulo ASP.NET) permite a ASP.NET enviar una copia de una 
página preprocesada en lugar de pasar por este proceso para cada solicitud. Esta 
diferencia reduce el volumen de procesamiento del servidor web, lo que aumenta 
el rendimiento y la posibilidad de una escalabilidad mayor. 


Como ejemplo, vamos a crear un formulario web que muestre la hora actual 
en una etiqueta y el contenido de la tabla telefonos de la base de datos 


CAPÍTULO 16: FORMULARIOS WEB 831 


bd telefonos, que creamos en un capítulo anterior, en una rejilla (objeto 
GridView). El diseño podría ser así: 


<body> 
<form id="forml" runat="server"> 
<div> 
<asp:Label ID="Labell1" runat="server" Text="Label" /><br /> 
<br /> 
<asp:GridView ID="GridViewl1" runat="server"></asp:GridView> 
</div> 
</form> 
</body> 


Una vez hayamos realizado el diseño y añadido la capa de datos formada por 
el modelo generado con ADO.NET Entity Framework a partir de la base de datos 
bd telefonos, añada el siguiente controlador, en el fichero de código subyacente, 
para que responda al evento Load del formulario: 


protected void Page_load(object sender, EventArgs e) 
( 
Labell.Text = System.DatelTime.Now.ToString(); 


using (bd_telefonosContexto contexto0bjs = 
new bd_telefonosContexto()) 
( 
GridViewl.DataSource = contexto0bjs.telefonos.ToList(); 
GridViewl.DataBind(); 





) 
) 


Nota: el usuario Servicio de red debe tener suficientes privilegios para acce- 
der a la base de datos. 


Esta aplicación, puede obtenerla de la carpeta Cap16WebSiteCache del CD 
correspondiente al libro. 


Para probar cómo funciona la aplicación ASP.NET, pulse las teclas Ctrl +F5 
para ejecutar la página. Cuando se muestre esta en el navegador, observará la fe- 
cha y hora actuales y el contenido de la tabla telefonos. Haga clic en el botón de 
actualización del explorador y observe que la hora cambia cada vez. El contenido 
de la rejilla permanece invariable. Para finalizar, cierre el explorador. 
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Configurar el almacenamiento en caché a nivel de página 


Una vez creada la aplicación, vamos a configurar el almacenamiento en caché a 
nivel de página. Para ello, agregue la siguiente directiva en la parte superior de la 
página: 


<%@ OutputCache Duration="30" VaryByParam="none" %> 


Esta directiva indica que la página se va a almacenar en memoria caché du- 
rante 30 segundos. La directiva @ OutputCache exige que se establezca el atri- 
buto VaryByParam. Este atributo permite configurar el almacenamiento en la 
caché en función de un parámetro de la URL. Otros atributos como VaryByHea- 
der lo permiten en función de una cabecera del navegador; VaryByControl per- 
mite configurar el almacenamiento en la caché del contenido de un control o 
controles en función de una propiedad del control, y VaryBycustom, en función 
de un parámetro definido por el programador. 


Si ahora vuelve a ejecutar la aplicación ASP.NET y, al igual que antes, actua- 
liza repetidas veces la página, observará que la hora se actualizará solo cada 30 
segundos. Esto es debido a que la solicitud se atiende desde la caché hasta que 
transcurre el tiempo especificado, momento en el que se vuelve a ejecutar el códi- 
go de la página. 


Actualización dinámica de fragmentos de una página en caché 


En algunas ocasiones, es posible que desee almacenar en memoria caché la mayor 
parte de una página y a la vez poder actualizar la información de la página que va- 
ría con el tiempo. Para esto, puede utilizar el control Substitution, el cual permite 
crear áreas en la página que se ha configurado para almacenarse en memoria ca- 
ché, para que puedan actualizarse dinámicamente para integrarse después en dicha 
página. 


Para utilizar el control Substitution, colóquelo en la ubicación de la página 
donde desee que aparezca el contenido dinámico. Durante la ejecución, este con- 
trol llamará a un método especificado por el atributo MethodName, que deberá 
devolver una cadena que se mostrará en el lugar de la página ocupado por el con- 
trol. El método al que nos referimos debe: 


e Estar definido como un método estático (Shared en Visual Basic). 
e Aceptar un parámetro de tipo HttpContext. 
e Devolver un valor de tipo String. 
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Por ejemplo, vamos a sustituir la etiqueta del ejemplo anterior que mostraba 
la hora, 


<body> 
<form id="forml" runat="server"> 
<div> 
<asp:Label ID="Labell" runat="server" Text="Label"></asp:Label> 


por un control de sustitución como el siguiente: 


<body> 
<form id="form1" runat="server"> 
<div> 
<asp:Substitution ID="Hora" runat="server" MethodName="hora" /> 


Este control será sustituido por la cadena devuelta por el método hora, que 
implementaremos en el fichero de código subyacente así: 


protected static string hora(HttpContext ©) 
( 


return System.DateTime.Now.ToString(); 


1 
$ 


Tenga en cuenta que el control Substitution no puede tener acceso a otros 
controles de la página. Sin embargo, el código tiene acceso al contexto de la pági- 
na actual a través del parámetro c que se le ha transferido. 


Configurar el almacenamiento en caché por programación 


También puede especificar que una página se almacene en caché mediante pro- 
gramación. Para ello, en el código de la página, llame al método SetCacheability 
de la propiedad Cache del objeto Response. 


Response.Cache.SetCacheability(HttpClacheability.Public); 
La enumeración HttpCacheability define los valores siguientes: 


e  NoCache. Evita que un navegador almacene una página en su carpeta de his- 
torial, de tal forma que siempre que un usuario haga clic en un botón hacia 
delante o hacia atrás, se solicitará una nueva versión de la respuesta. 


e Public. La respuesta se almacena en memoria caché en el cliente y en cachés 
compartidas (servidor proxy). 


e Private. La respuesta solo se almacena en memoria caché en el cliente y no en 
cachés compartidas (servidor proxy). 
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e Server. La respuesta solo se almacena en memoria caché en el servidor de 
origen. 


e  ServerAndNoCache. Opciones Server y NoCache. 


e  ServerAndPrivate. Opciones Server y Private. 


Por ejemplo, para establecer la caducidad de una página en la caché de resul- 
tados mediante programación, proceda así: 


Response.Cache.SetExpires(Datelime.Now.AddSeconds(30)); 
Response.Cache.SetCacheability(HttpCacheability.Public); 
Response.Cache.SetValidUntilExpires(true); 


Este ejemplo de código realiza la misma función que la directiva @ Output- 
Cache del ejemplo anterior. 


Se puede configurar el almacenamiento en caché en memoria sin asignarlo a 
la salida de una página o control. Para ello tendremos que emplear la clase Cache 
del espacio de nombres System.Web.Caching que se manipula de manera análo- 
ga a una colección. 


Almacenamiento en caché de datos procedentes de SQL Server 


Una característica avanzada de almacenamiento en la caché de resultados de 
ASP.NET es la dependencia de la caché de SQL, la cual permite almacenar pági- 
nas que dependen de datos de las tablas SQL Server. 


Puede configurar SQL Server y ASP.NET para almacenar solicitudes de pá- 
ginas en la memoria caché, reduciendo la carga de trabajo del servidor, hasta que 
los datos de los que depende la página se hayan actualizado en SQL Server. La 
dependencia de la caché de SQL es práctica para datos como catálogos de produc- 
tos o información de registro de clientes, que es relativamente estática. 


Para habilitar la notificación de caché para SQL Server siga los pasos enume- 
rados a continuación: 


1. Abra una consola del sistema. 


2. Localice el fichero aspnet regsql.exe en su instalación de .NET Framework, 
cambie a ese directorio y ejecute la orden siguiente: 


aspnet_regsql.exe -S servidorAsqlexpress -E -ed -d bd_telefonos 
-et -t telefonos 


CAPÍTULO 16: FORMULARIOS WEB 835 


Para ejecutar esta orden necesitará privilegios de administrador. A continua- 
ción, aparecerá un mensaje que indicará si se pudo habilitar la base de datos. 
El siguiente mensaje indica que se pudo habilitar: 


Habilitando la base de datos para la dependencia de la caché de SQL. 
Finalizado. 


Habilitando la tabla para la dependencia de la caché de SQL. 
Finalizado. 


A continuación y continuando con la aplicación anterior, configurará la pági- 
na para establecer la base de datos y la tabla de la que depende la entrada de la ca- 
ché. De esta forma, SQL Server notificará a la aplicación cuándo hay cambios en 
los datos que están en la caché. En otras palabras, la entrada de la caché caduca 
cuando se actualizan o modifican los datos de la tabla. Agregue la siguiente direc- 
tiva para indicar la dependencia: 


<%@ OutputCache Duration="3600" 
SqlDependency="bd_telefonos:telefonos” VaryByParam="none" %> 


Además de la declaración de OutputCache, es necesario especificar en el fi- 
chero Web.config los detalles del almacenamiento en caché. Si la aplicación aún 
no tiene un fichero Web.config, añádalo. Edite este fichero y agregue el siguiente 
código XML como elemento secundario del elemento system.web: 


<caching> 
<sqlCacheDependency enabled = "true" pollTime = "1000" > 
<databases> 
<add name="bd_telefonos" 
connectionStringName="bd_telefonosConnectionStringl" 
pollTime = "1000" 
4> 
</databases> 
</sqlCacheDependency> 
</caching> 


El elemento sqlCacheDependency define los valores que utiliza la clase 
SqlCacheDependency y el atributo pollTime establece la frecuencia en milise- 
gundos con que SqlCacheDependency sondea la tabla de base de datos para bus- 
car los cambios. 


Para probar esta nueva característica de almacenamiento en la caché de resul- 
tados de ASP.NET dependiente de SQL, elimine el control de sustitución que 
añadió anteriormente y habilite de nuevo la etiqueta para que muestre la hora. 
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Ejecute la aplicación y observe que la hora permanece igual cada vez que actuali- 
za la página. La página se obtiene de la memoria caché. 


Ahora pruebe a cambiar los datos en la base de datos a través del Explorador 
de servidores (Explorador de bases de datos). Si ahora vuelve a actualizar la pá- 
gina, observará que se actualizarán la hora y los datos de la tabla mostrados en la 
rejilla. SQL Server notificó a la aplicación que hubo cambios en los datos que es- 
tán en la caché, lo que hizo que caducara la duración permitiendo refrescar la pá- 
gina. 


Reducir la información hacia y desde el servidor 


Una aplicación web no tiene estado; esto es, cada vez que el servidor solicita una 
página se crea un nuevo ejemplar de la clase de página web, lo cual supone que 
toda la información asociada con la página y sus controles se pierde. 


ViewState (propiedad que los controles heredan de la clase Sys- 
tem.Web.UI.Control) es el mecanismo que ASP.NET utiliza para realizar el se- 
guimiento de los valores de estado de los controles del servidor que de otra forma 
no se devolverían como parte del formulario HTTP. 


Este mecanismo, según vimos anteriormente, se basa en un campo oculto in- 
yectado por ASP.NET en el formulario. Cuando el servidor devuelve la página al 
cliente, ASP.NET recopila los valores de ViewState correspondientes a dicha pá- 
gina y a todos los controles, los formatea en una única cadena codificada y, a con- 
tinuación, se los asigna al atributo de valor del campo oculto del formulario. El 
ViewState viaja con la página, así que cuando el cliente decide enviar de nuevo la 
página al servidor, también lo hará la cadena del ViewState. 


Volvamos a la aplicación desarrollada en el apartado anterior. Para ver la can- 
tidad de información que añade el mecanismo ViewState al formulario web, ejecu- 
te la aplicación y cuando el navegador muestre la página, elija la opción “Ver 
Código fuente” de la página y observe el valor del campo oculto VIEWSTATE: 


<div> 

<input type="hidden" name="__VIEWSTATE" id="__VIEWSTATE" va- 
lue="T1H1aMinH0Q0Bs1i1Ss76809fAdw3jGmc1pz7VblvqBRtOfvVS6g0ejs530fiVo4 
We+s164wLX304B75txD4HBg5/fj8pErz2eB8a/t0ALacCzAMmGdUVJ8A05vFO1q1ACB 





AkTTO7vTWenbXWih21LqbRzNm0ZUulgld9MHM8+d8kPfeMq9g9kcVO/06vJDDsqWGZue" 
/> 
</div> 
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Observamos que la cantidad de información que viaja con la página debida al 
mecanismo ViewState es considerable, lo cual repercutirá considerablemente en el 
rendimiento de la aplicación. 


¿Se puede deshabilitar el mecanismo ViewState? Se puede deshabilitar, ahora 
bien, ¿cuándo lo haremos? Pues cuando la página presente datos que van a ser de 
solo lectura o datos no necesarios para el servidor. Por ejemplo, si en nuestra apli- 
cación suponemos que la rejilla tiene como única misión presentar los datos, sería 
un control candidato para deshabilitar su ViewState. 


El ViewState se puede deshabilitar a nivel de la página, poniendo a false el 
atributo EnableViewState de la directiva Page: 


<%@ Page Language="C¿f" AutoEventWireup="true" CodeFile= 


"Default.aspx.cs" Inherits="_Default" EnableViewState="false" %> 


También se puede deshabilitar a nivel de un control: 


<asp:GridView ID="GridViewl" runat="server" EnableViewState="false" 
</asp:GridView> 


Observe cómo después de hacer esta última operación la carga de la página 
debida al ViewState ha disminuido considerablemente. 


Quizás, cuando deshabilitó el mecanismo ViewState observó que aún se en- 
viaba información de estado. Esto es porque el campo oculto  VIEWSTATE 
exactamente contiene dos tipos de información: el estado de vista propiamente di- 
cho, al que se añade el estado de control. El estado de control es utilizado por al- 
gunos controles para incluir cualquier valor de propiedad crítico en 
_ VIEWSTATE. Piense que algunos controles (por lo general, controles enrique- 
cidos de terceros y controles personalizados) tienen que conservar información 
privada entre devoluciones para su propio funcionamiento (por ejemplo, el estado 
contraído/expandido de un panel desplegable). Entonces, a diferencia del estado 
de vista tradicional, el estado de control no se puede deshabilitar, por lo que siem- 
pre está disponible. 


CONTROLES DE SERVIDOR COMO ORIGEN DE DATOS 


Las páginas web, a menudo, precisan mostrar información derivada de una base 
de datos. Sin embargo, debido a la naturaleza de las páginas de formularios web, 
el acceso a una base de datos desde un formulario web difiere en varios aspectos 
del acceso a datos en los formularios Windows. De algún modo, estas son las 
mismas diferencias que hacen cualquier tipo de programación web distinta de la 
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programación de los formularios tradicionales: la administración del estado, la se- 
paración entre cliente y servidor, el diseño pensado para la escalabilidad, etc. 


El acceso a los datos almacenados en una base de datos desde una página 
construida a partir de un formulario web se basa en los siguientes principios fun- 
damentales: 


e Utilización de un modelo desconectado. Los formularios web están desconec- 
tados; esto es, siempre que se solicita una página web basada en un formula- 
rio, esta se genera, se procesa, se envía al explorador y se desecha de la 
memoria del servidor. Si la página incluye acceso a una base de datos, los da- 
tos se leen o actualizan mientras la página se procesa en el servidor, y cuando 
finaliza y se envía al explorador, se desechan los datos junto con el resto de 
los elementos de la página. No resulta práctico mantener abiertas las conexio- 
nes con los orígenes de datos. El dejar la conexión abierta puede impedir que 
otro cliente tenga acceso a la base de datos si el gestor de base de datos tiene 
un número limitado de conexiones. Por eso, durante el procesamiento de una 
página se abre una conexión con los datos, de lectura o de escritura y, a conti- 
nuación, se cierra la conexión. 


e Mayor frecuencia de lectura de los datos que de su actualización. La mayoría 
de los accesos a los datos mediante páginas web es de solo lectura, lo que 
confiere a la página una mayor eficiencia; es decir, normalmente, utilizamos 
un enlace a una base de datos para mostrar información en los controles de 
una página, pero no para escribir los datos de los mismos en la base de datos. 
Los formularios web predeterminados no incluyen un modo de escribir datos 
de un control en un origen de datos. Por lo tanto, si se crea una página que ac- 
tualice una base de datos, se deberá incluir la lógica para realizar las opera- 
ciones de actualización. 


e Reducción al máximo de los requisitos de recursos del servidor. Debido a que 
un formulario web se procesa en el servidor antes de ser enviado al explora- 
dor, cualquier acceso a datos agrega a la carga del servidor tiempo de proce- 
samiento y uso de memoria. Esto significa que si se decide guardar los datos 
entre las acciones de ida y vuelta y se almacenan en el servidor, se utilizarán 
recursos de este aunque la página no se esté procesando. Esta forma de proce- 
der será dificil de manejar cuando sean muchos los usuarios que acceden si- 
multáneamente. Por lo tanto, en estos casos es necesario poner un especial 
cuidado en el diseño para minimizar los efectos, por ejemplo, obteniendo solo 
tantos datos como se precisen en cada instante. 


e Acceso a los datos mediante procesos remotos (acceso a datos distribuido). Es 
muy normal separar la lógica de acceso a los datos de la interfaz de usuario 
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generándola en otro componente, por ejemplo, en un servicio web que inter- 
actúe con el origen de datos. 


ASP.NET provee varios tipos de objetos para realizar conexiones con diferen- 
tes tipos de orígenes de datos (véase el capítulo titulado Acceso a una base de da- 
tos y el capítulo titulado LINO). Ahora bien, cuando se trate de acceder a datos 
desde un formulario web, es más adecuado utilizar Entity Framework, según he- 
mos visto en los ejemplos anteriores, o los controles de servidor origen de datos 
tales como SqlDataSource, o EntityDataSource. Estos controles permiten a un 
control web, tal como GridView, DropDownList, ListView, DetailsView, etc., 
acceder a los datos de una base de datos utilizando sentencias SQL. SqlData- 
Source, a pesar de su nombre, se puede utilizar con cualquier base de datos para 
las que ADO.NET proporcione un proveedor, como son SOL Server u Oracle, así 
como con bases de datos a las que se pueda acceder a través de ODBC y OLE DB. 


SQL y desarrollo web 


Después de esta breve introducción, vamos a realizar una aplicación que utilice un 
formulario web para acceder a una base de datos Microsoft SQL Server utilizando 
como origen de datos el control SqlDataSource (puede obtenerla de la carpeta 
Cap16SqlDataSource del CD correspondiente al libro). Esta aplicación tendrá el 
mismo aspecto que la realizada al principio de este capítulo, FormWebNotas, rela- 
tiva al diseño de un formulario web para que un alumno pueda consultar a través 
de Internet las notas de las asignaturas que ha cursado en una determinada institu- 
ción. Recuerde que los datos estaban almacenados en una base de datos SOL Ser- 
ver, bd_notasAlumnos, con la siguiente estructura: 














alumnos asignaturas 
Y id_alumno Y id_asignatura 
nombre nombre 





alums_asigs 
Y id_alumno 
—— Y ¡d_asignatura po 


nota 








La tabla alumnos contiene los nombres de los alumnos que están cursando es- 
tudios, la tabla asignaturas contiene los nombres de todas las asignaturas de las 
que un alumno puede matricularse y, por lo tanto, puede consultar su nota y la ta- 
bla alums_asigs, las notas de los alumnos id_alumno matriculados en la asignatu- 
ra id asignatura. Las relaciones entre las tablas reflejan que un alumno puede 


840 ENCICLOPEDIA DE MICROSOFT VISUAL CH 


estar matriculado de muchas asignaturas y que una asignatura puede ser objeto de 
matriculación de muchos alumnos. 


Para desarrollar esta aplicación web, suponiendo ya creada la base de datos, 


podemos seguir los pasos indicados a continuación: 


Cree un nuevo sitio web vacío (Archivo > Nuevo > Sitio web) denominado 
SqlDataSource. Añada un formulario web al sitio. A continuación, agregue 
los controles al formulario web para construir el mismo formulario que dise- 
ñamos anteriormente en este mismo capítulo para el sitio FormWebNotas, con 
lo cual tenemos todo el trabajo de diseño realizado. 


Diríjase al explorador de bases de datos y agregue una nueva conexión para 
bd_notasAlumnos.mdf (clic con el botón secundario del ratón sobre el nodo 
Conexiones de datos del explorador de bases de datos), lo que le permitirá, 
además, observar la estructura de la base de datos, modificarla, mostrar los 
datos de las tablas y agregar, si lo desea, datos a las mismas. 


Explorador de servidores y Ax 
19] + ll 


4 gl Conexiones de datos 


4 W Tablas 
bo Œ alumnos 
b EH alums_asigs 
b EH asignaturas 
> El Vistas 
> El Procedimientos almacenados 
> E Funciones 
> ml Sinónimos 
> ml Tipos 
> ml Ensamblados 


Añada el controlador del evento Click del botón y déjelo de momento vacío. 
Implemente el modo de validación discreto necesario para los controles de va- 
lidación según explicamos anteriormente en el apartado Controles de valida- 
ción. 


Genere la aplicación y ejecute el formulario web. 
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r | mn = pza 
a http://localhost/SqlDataSource/Default.as © ~ Ed || Æ Formulario web notas e 
DNI: * + DNI requerido 
si 
Consultar nota | 
Nombre: 
Nota: 
Error: 
< > 
Xx "i 
Control SqlDataSource 


El control SqlDataSource encapsula la funcionalidad ADO.NET requerida para 
interactuar con bases de datos, permitiendo acceder y manipular datos desde un 
formulario web sin tener que utilizar las clases ADO.NET directamente. Para uti- 
lizarlo, basta con proporcionarle la cadena de conexión y las sentencias SQL (SE- 
LECT, INSERT, UPDATE y DELETE) necesarias; con esta información, el 
control automáticamente abrirá y cerrará la conexión con la base de datos y ejecu- 
tará las sentencias SQL solicitadas, indirecta o directamente a través de sus méto- 
dos Select, Insert, Update o Delete. 


SqlDataSource se puede configurar para que se comporte como un objeto 
DataReader o DataSet (propiedad DataSourceMode). Por ejemplo, si utiliza- 
mos este control como fuente de datos para una lista desplegable, la mejor solu- 
ción sería configurarlo como un DataReader; ahora, si lo utilizamos como fuente 
de datos para un componente GridView con capacidad para realizar operaciones 
de paginación, ordenación o selección con los datos en memoria, optaremos por el 
modo DataSet. 


Siguiendo con la aplicación, añada un objeto de la clase SqlDataSource del 
espacio de nombres System.Data.SqlClient para interactuar con la base de datos 
bd_notasAlumnos. Para ello, estando en la ventana de diseño, no tiene nada más 
que arrastrarlo sobre el formulario desde el panel Datos de la caja de herramientas 
de Visual Studio. Asígnele, por ejemplo, el nombre FuenteDeDatosSql. Abra la 
lista de tareas de este control y haga clic en Configurar origen de datos: 
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Global.asax Default.aspx.cs 
asp: ql atasources+ rFuenteDevatos>g 


| SqlDataSource - FuenteDeDatossal [Ë 





Tareas de SqlDataSource 











+ Mensaje de error 1. 
DNI: ak ae 


i je de error 2. 
| Establecer la configuración del origen de datos. y 
Sin enlazar y 


Cuando haga clic se le mostrarán una serie de diálogos que le solicitarán ele- 
gir la conexión de datos, guardar la cadena de conexión en el archivo de configu- 
ración de la aplicación y configurar la instrucción Select: 





r 





= > 
Configurar origen de datos - FuenteDeDatosSql [0 ea) 





= Configurar la instrucción Select 


¿Cómo desea recuperar los datos de la base de datos? 


> Especificar una instrucción SQL o un procedimiento almacenado personalizado 
(9) Especificar columnas de una tabla o vista 
Nombre: 





asignaturas y 





Columnas: 





. 


(m E Devolver sólo filas únicas 
|V id_asignatura 


' EEC E 


ORDER BY... 





Avanzadas... 


L 
Instrucción SELECT: 
SELECT [id_asignatura], [nombre] FROM [asignaturas] 





ce rd 


Cancelar 

















= 





La sentencia Select de FuenteDeDatosSql la configuraremos para que de- 
vuelva los nombres e identificadores de las asignaturas de la tabla asignaturas. 


A continuación, abra la lista de tareas de la lista desplegable /sdAsignatura y 
vincule esta con el origen de datos FuenteDeDatosSql para que muestre los nom- 
bres de las asignaturas y almacene los identificadores correspondientes, según 
muestra la figura siguiente: 
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= > 
Asistente para la configuración de orígenes de datos [ENS 





E Elegir un origen de datos 


Seleccionar un origen de datos: 





FuenteDeDatosSql sz 





Seleccionar un campo de datos para mostrar en DropDownList: 


nombre y 


Seleccionar un campo de datos para el valor de DropDownList: 


id_asignatura X 


Actualizar esquema 





| Aceptar Cancelar | 














Esta acción asignará a la propiedad DataSourcelD de /sdAsignatura la fuente 
de datos FuenteDeDatosSql; a DataTextField, el campo nombre de la tabla asig- 
naturas, y a DataValueField, el campo id_ asignatura de la misma tabla. 


Las acciones anteriores se reflejarán en el fichero Default. aspx como se mues- 
tra a continuación: 


<asp:SqlDataSource ID="FuenteDeDatosSql" runat="server" 
ConnectionString="<%$ ConnectionStrings: 
bd_notasAlumnosConnectionString %>" 
SelectCommand="SELECT [id_asignatura], [nombre] FROM [asignaturas]"> 
</asp:SqlDataSource> 


<asp:DropDownList ID="lsdAsignatura" runat="server" 
Style="z-index: 102; left: 210px; 
position: absolute; top: 104px" Width="320px" 
DataSourcelD="FuenteDeDatosSql" 
DataTextField="nombre" DataValueField="id_asignatura"> 
</asp:DropDownList> 





Puede observar que la cadena de conexión que se definió cuando configuró el 
SqlDataSource queda especificada en el fichero Web.config. 


Si ahora ejecuta la aplicación, observará que la lista se llena con los nombres 
de las asignaturas. Si no es así y lo que se visualiza es un error de que no se puede 
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abrir la base de datos solicitada porque la conexión para el usuario NT AUTHO- 
RITY Servicio de Red falla, es porque el usuario mencionado no tiene permisos 
para acceder a la base de datos. En este caso proceda como se explicó en el apar- 
tado Obtener acceso a la base de datos anteriormente en este mismo capítulo. 


Responder a los eventos 


Cuando un usuario solicite desde un explorador, al servidor correspondiente, que 
se ejecute nuestra aplicación web, se visualizará en el mismo el formulario De- 
fault.aspx generado y enviado por ese servidor. Al cargarse este formulario, se 
mostrará la lista de las asignaturas que el alumno puede consultar, según puede 
observarse en la figura anterior. 


A continuación, el alumno escribirá su DNI y seleccionará de la lista la asig- 
natura de la que quiere consultar la nota. 


Después, hará clic en el botón Consultar nota, instante en el que la página se- 
rá enviada al servidor. El proceso de esta página tiene que obtener el nombre del 
alumno y la nota obtenida en la asignatura seleccionada y devolver la página mo- 
dificada con estos datos al cliente. Este proceso lo podemos enfocar desde dos 
puntos de vista: escribiendo código en el controlador del evento Click del botón 
que haga la consulta a la base de datos y obtenga los datos que serán mostrados 
por las etiquetas de la interfaz gráfica, o utilizando un segundo control SqlData- 
Source programado para que haga esa consulta, siendo origen de datos de otro 
control DetailsView que sustituiría a las etiquetas para mostrar los resultados. 


Vamos a implementar la primera opción y la segunda la dejamos para el apar- 
tado de ejercicios propuestos. Según esto, añadimos el controlador btConsultar- 
Nota_Click para manejar el evento Click del botón. La función de este método es 
buscar la nota de la asignatura seleccionada por el alumno que se ha identificado. 
Para ello, este método abre una conexión con la base de datos, realiza una consul- 
ta sobre la base de datos, utilizando como parámetros ctDni.Text y IsdAsignatu- 
ra.Selectedltem. Value, para obtener el nombre y la nota del alumno que se 
identificó y coloca los resultados obtenidos en las etiquetas correspondientes de la 
página. Los resultados de las consultas se almacenan en un objeto Lector de la 
clase SqlDataReader. Ocurra lo que ocurra, la ejecución del método finaliza ce- 
rrando la conexión con el origen de datos. 


Para abrir una conexión con la base de datos, recuperamos la cadena de cone- 
xión del fichero de configuración Web.config de la forma siguiente: 


ConexionConBD.ConnectionString = ConfigurationManager. 
ConnectionStrings["bd_notasAlumnosConnectionString"]. 
ConnectionString; 
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La clase ConfigurationManager del espacio de nombres System.Configu- 
ration (añada una referencia al proyecto para este espacio y la directriz using co- 
rrespondiente en Default. aspx.cs) proporciona acceso a los ficheros de configuración 
de la aplicación para obtener datos acerca de los usuarios, de la aplicación y del 
equipo. Por ejemplo, la propiedad (static) ConnectionStrings de esta clase hace 
referencia a una colección de tipo ConnectionStringSettingsCollection que al- 
macena la información correspondiente a la sección del fichero de configuración 
relacionada con las cadenas de conexión. 


Cuando la ejecución del código finalice, la página se vuelve a enviar al explo- 
rador con los cambios realizados por el código: la etiqueta e£Nombre mostrará el 
nombre del alumno y la etiqueta etNota visualizará la nota obtenida en la asigna- 
tura seleccionada, o bien la etiqueta etError mostrará un mensaje de error, o de 
que el alumno no está en el acta, si fue esto lo que ocurrió. 


using System.Data.SqlClient; 
using System.Configuration; 
/1 


public partial class FormWebNotas : System.Web.UI.Page 
{ 
protected void Page_Load(object sender, EventArgs e) 
{ 
etError.Text = 
) 


protected void btConsultarNota_Click(object sender, EventArgs e) 
( 
// Objeto conexión con la base de datos 
SqlConnection ConexionConBD = new SqlConnection(); 
// Cadena de conexión (véase Web.config) 
ConexionConBD.ConnectionString = ConfigurationManager. 
ConnectionStrings["bd_notasAlumnosConnectionString"]. 
ConnectionString; 

















// Objeto orden SQL 
SqlCommand OrdenSQL = null; 
// Objeto lector de datos SQL 
SqlDataReader Lector = null; 


try 
( 
// Consulta para buscar el nombre y la nota del alumno "ctDni”. 
string Consulta = "SELECT alumnos.nombre, alums_asigs.nota " + 
"FROM alumnos, asignaturas, alums_asigs " + 
"WHERE alumnos.id_alumno=" + Convert.Tolnt32(ctDni.Text) + 
" AND asignaturas.id_asignatura=" + 
lIsdAsignatura.Selectedltem.Value + 
" AND alumnos.id_alumno=alums_asigs.id_alumno" + 
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" AND asignaturas.id_asignatura=alums_asigs.id_asignatura"; 


OrdenSQL = new SqlCommand(Consulta, ConexionConBD); 
ConexionConBD.Open(); // abrir una conexión con la BD 
// Obtener los datos 

Lector = OrdenSOL.ExecuteReader(); 

if (Lector.Read()) 

( 
// Mostrar en la página el nombre y la nota 
etNombre.Text = "Nombre: " + LectorL"nombre"]; 
etNota.Text = "Nota: " + Lector["nota"]; 
etError.Text = ""; 





) 

else 

( 
// El alumno buscado no se encontró 
etNombre.Text = ""; 

etNota.Text = ""; 

etError.Text = "Error: no está en acta"; 


) 


// Llamar siempre a Close una vez finalizada la lectura 
Lector.Close(); 
Lector = null; 
) 
catch (System.I0.IOException exc) 
( 
etError.Text = "Error: 
) 
finally 
( 
// En cualquier caso, cerrar la conexión 
if (Lector != null) Lector.Close(); 
if (ConexionConBD != null) ConexionConBD.Close(); 
) 
) 





+ exc.Message; 


} 


LINQ y desarrollo web 


Como sabemos, LINQ es una combinación de extensiones al lenguaje y bibliote- 
cas de código administrado que permite expresar de manera uniforme consultas 
sobre colecciones de datos de diversa procedencia utilizando recursos del propio 
lenguaje de programación. 


En ASP.NET, todos los controles de datos, como GridView, ListView, De- 
tailsView, DropDownList, DataList, Repeater, etc., pueden consumir datos de- 
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vueltos por una consulta escrita en LINQ sobre un modelo de objetos generado 
por Entity Framework. Por ejemplo: 
<asp:DropDownList ID="lsdAsignatura" runat="server" 
Style="z-index: 102; left: 210px; 
position: absolute; top: 104px" Width="300px" 
DataSourcelD=" i 
DataTextField="nombre" DataValueField="id_asignatura"> 
</asp:DropDownList> 





Control EntityDataSource 


Para facilitar el consumo de datos de consultas LINQ en aplicaciones web que uti- 
lizan Entity Framework, con la versión 3.5 de .NET Framework se presentó un 
nuevo objeto de negocio para acceso a datos, diseñado para trabajar directamente 
con los modelos de objetos generados por Entity Framework, denominado Enti- 
tyDataSource. 


Aplicación web 


EntityDataSource 








ase de dato 
relacional 


Según expresa la figura anterior, el control EntityDataSource permite con- 
sultar un modelo de objetos (obtenido a partir del EDM: Entity Data Model) y en- 
lazar los datos obtenidos de la consulta a controles del formulario. 


El control EntityDataSource permite utilizar LINQ en una página web 
ASP.NET estableciendo en HTML las propiedades adecuadas para poder conec- 
tarse al EDM y devolver los resultados requeridos. Cuando utilizamos este objeto 
para recuperar datos desde un modelo de objetos en memoria, sus propiedades 
ConnectionString y DefaultContainerName permiten crear el contexto de obje- 
tos (objeto de la clase DbContext) utilizado para ejecutar las consultas, su pro- 
piedad EntitySetName especifica el nombre del conjunto de entidades a 
consultar, Entity TypeFilter solo se establece cuando el control debe devolver un 
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tipo derivado específico, y su propiedad Select especifica las propiedades (colum- 


nas de datos) que se quiere incluir en el resultado de la consulta. Por ejemplo: 
<asp:EntityDataSource ID=" " runat="server" 
ConnectionString="name=bd_notasAlumnosEntities” 
DefaultContainerName="bd_notasAlumnosEntities" 
EntitySetName="alumnos" 
Select="it.[id_alumno], it.[nombre]"> 


</asp:EntityDataSource> 


Lo anteriormente expuesto indica que cuando se consulte una base de datos, 


primero debe crearse el modelo de objetos que represente la base de datos orien- 
tada a objetos virtual imagen del modelo relacional correspondiente a la base de 
datos física. Para generar este modelo, como vimos en los capítulos anteriores, 
puede usar el asistente para el EDM (Entity Data Model) y, después, establecer las 
propiedades mencionadas anteriormente. 


Como ejemplo, vamos a reproducir la aplicación anterior pero utilizando aho- 


ra un control EntityDataSource en lugar de un LinqDataSource (puede obtener- 
la de la carpeta Cap161EntityDataSource del CD correspondiente al libro). Los 
pasos a seguir son los siguientes: 


l. 


Cree un nuevo sitio web denominado EntityDataSource. Añada un formulario 
web al sitio. 


Diseñe la interfaz gráfica arrastrando los controles correspondientes desde la 
caja de herramientas a la superficie de diseño. 


Implemente el modo de validación discreto necesario para los controles de va- 
lidación según explicamos anteriormente en el apartado Controles de valida- 
ción. 


Abra el explorador de bases de datos/explorador de servidores y añada una 
conexión a la base de datos bd_notasAlumnos. 


Agregue un nuevo elemento de tipo ADO.NET Entity Data Model al proyecto 
para abrir el asistente para el EDM. Póngalo en la carpeta App_Code del pro- 
yecto. Genere el modelo desde las tablas alumnos, alums_asigs y asignaturas 
de la base de datos bd_notasAlumnos. Para más detalles véase el capítulo 
LINO. 


El resto de la implementación será análogo a lo que ya hicimos cuando utili- 
zábamos el control SqlDataSource, pero ahora utilizando como control de 
acceso a datos EntityDataSource y como fuente de datos para este control el 
modelo de objetos que acabamos de generar, bd_ notasAlumnosEntities: 
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MESES Y AX 
a. O S -| % 
<Búsqueda> - P 


4 [5] http://localhost/EntityDataSource/ 
b El Referencias del proyecto 
b fg alum_asig 
p % alumno 
b %; asignatura 
y 
0 bd_notasAlumnosEntities() 
O, OnModelCreating(System.Data.Entity.DoModelBuilder) 
# alumnos 





# alums_asigs 
# asignaturas 


4 > 


Explorador de solu... Vista de clases Explorador de servi... 


Siguiendo con la aplicación, añada un objeto de la clase EntityDataSource 
del espacio de nombres System.Web.ULWebControls para interactuar con el 
contexto de objetos de la clase bd_notasAlumnosEntities. Para ello, estando en la 
ventana de diseño, no tiene nada más que arrastrarlo sobre el formulario desde el 
panel Datos de la caja de herramientas de Visual Studio. Asígnele, por ejemplo, el 
nombre FuenteDeDatosEDS. Abra la lista de tareas de este control y haga clic en 
Configurar origen de datos: 


Default.aspx.cs 
asp:entiyDatasources ruenteDeDatos 


EntityDataSource - FuenteDeDatosEDS Tareas de EntityDataSource 


[Sin enlazar 

















+ Mensaje de error 1. 


DMonania da 
> E error 2. 
Establecer la configuración del origen de datos. 

v 


Cuando haga clic se le mostrarán una serie de diálogos que le solicitarán: 


DNI: 





1. Configurar el contexto de objetos. Esta acción asignará a la propiedad Con- 
nectionString la cadena de conexión y a DefaultContainerName el nombre 
de la clase del contexto. Ambas propiedades permiten al control crear el con- 
texto de objetos (objeto de la clase DbContext) utilizado para ejecutar las 
consultas que, en nuestro caso, será un objeto de la clase bd notasAlumnos- 
Entities: 
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Configurar origen de datos - FuenteDeDatosEDS L E 


«y Configurar ObjectContext 





ConnectionString: 


@ Conexión con nombre 





bd_notasAlumnosEntities X 





© Cadena de conexión 


DefaultContainerName: 





bd_notasAlumnosEntities X 























2. Configurar la selección de datos. La propiedad Select de FuenteDeDatosEDS 
la configuraremos para que devuelva los nombres e identificadores de las 
asignaturas de la tabla asignaturas: 
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Configurar origen de datos - FuenteDeDatosEDS [EAS] 


«y Configurar selección de datos 





EntitySetName: 





asignaturas Z 





EntityTypeFilter: 





(Ninguno) =] 





Elija las propiedades en el resultado de la consulta: 





[E Seleccionar todo (valor de entidac 
[Y] id_asignatura 
7] 


nombre 








< Anterior | e Finalizar | | Cancelar | 























Además del asistente para configurar el origen de datos, disponemos del edi- 


tor de expresiones, que permite al usuario especificar expresiones textuales para 
las propiedades: 


Where. Especifica los filtros a aplicar sobre los resultados de la consulta. 
Order By. Especifica cómo se ordenan los resultados de la consulta. 

Select. Define los campos que se van a incluir en los resultados de la consulta. 
CommandText. Orden de Entity SOL que define la consulta. 


Para visualizar el editor de expresiones, seleccione la propiedad en la ventana 
de propiedades y haga clic en los puntos suspensivos situados al lado. Por ejem- 
plo, si necesitáramos editar la propiedad Where del control EntityDataSource 
(no es necesario para esta aplicación, es solo un ejemplo de cómo proceder), se- 
leccionaríamos esa propiedad en la ventana de propiedades correspondiente a este 
control y la editaríamos análogamente a como muestra la figura siguiente: 
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Editor de expresiones 





Expresión Where: 


ituid_asignatura == (Qid_asignatura && it.id_alumno == Qid_alumno 


El Generar automáticamente la expresión Where a partir de los parámetros proporcionados. 











Agregar parámetro 








Parámetros: Origen del parámetro: 
Nombre Valor [1] (Control 
id_asignatura IsdAsignatura.SelectedValue y AA 
id_alumno ctDni.Text = E 
Direction Input 
Name id_alumno 
PropertyName Text 
Size 0 
Type Int32] 
Type 


Tipo del parámetro. 


Ocultar propiedades avanzadas 




















mo] 








Aceptar Cancelar 














Siguiendo con la aplicación, vamos a asignar el control FuenteDeDatosEDS 
como origen de datos de la lista desplegable. Para ello, abra la lista de tareas de la 
lista desplegable IsdAsignatura y vincule esta con el origen de datos FuenteDe- 
DatosEDS para que muestre los nombres de las asignaturas y almacene los identi- 
ficadores correspondientes: 


r 








Asistente para la configuración de orígenes de datos 


Lo [esa 





El Elegir un origen de datos 


Seleccionar un origen de datos: 





FuenteDeDatosEDS Y 





Seleccionar un campo de datos para mostrar en DropDownList: 


nombre X 


Seleccionar un campo de datos para el valor de DropDownList: 


id_asignatura X 











Esta acción asignará a la propiedad DataSourceID de /sdAsignatura el origen 
de datos FuenteDeDatosEDS,; a DataTextField, el campo nombre de la entidad 
asignaturas; y a DataValueField, el campo id_ asignatura de la misma entidad. 
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Las acciones anteriores se reflejarán en el fichero Default. aspx como se mues- 
tra a continuación: 


<asp:EntityDataSource ID="FuenteDeDatosEDS" runat="server" 
ConnectionString="name=bd_notasAlumnosEntities" 
DefaultContainerName="bd_notasAlumnosEntities" 
EntitySetName="asignaturas" Select="it.[id_asignatura], it.[nombre]"> 
</asp:EntityDataSource> 


<asp:DropDownList ID="lsdAsignatura" runat="server" 
Style="z-index: 102; left: 210px; 
position: absolute; top: 104px" Width="320px" 
DataSourcelD="FuenteDeDatosEDS" 
DatalextField="nombre" DataValueField="id_asignatura"> 
</asp:DropDownList> 


Observe la utilización de it (“eso”) en el predicado. Es una palabra reservada 
predefinida para hacer referencia al nombre de la entidad que se consulta. 


Si ahora ejecuta la aplicación, observará que la lista se llena con los nombres 
de las asignaturas. Si no es así y lo que se visualiza es un error de que no se puede 
abrir la base de datos solicitada porque la conexión para el usuario NT AUTHO- 
RITY Servicio de Red falla, es porque el usuario mencionado no tiene permisos 
para acceder a la base de datos. En este caso proceda como se explicó en el apar- 
tado Obtener acceso a la base de datos anteriormente en este mismo capítulo. 


Responder a los eventos 


La finalidad de la aplicación es mostrar la nota de la asignatura seleccionada para 
el alumno identificado por su DNI. Por eso, cuando el alumno haya introducido 
estos datos, hará clic en el botón Consultar nota, instante en el que la página será 
enviada al servidor. ASP.NET analizará el evento que se ha producido y si existe 
un controlador para ese evento, se ejecutará inmediatamente. Para añadir este con- 
trolador, que denominaremos btConsultarNota Click, haga doble clic sobre el bo- 
tón del formulario. La función de este método es buscar la nota de la asignatura 
seleccionada por el alumno que se ha identificado. Para ello, el método creará el 
objeto contexto de objetos para interactuar con el modelo de objetos representati- 
vo de la base de datos, y, utilizando como parámetros el identificador del alumno 
(ctDni.Text) y el de la asignatura (/sdAsignatura.Selectedltem. Value), realizará 
una consulta que a continuación procesará con el fin de obtener los resultados y 
mostrarlos en las etiquetas correspondientes de la página. 


El código correspondiente al proceso descrito se muestra a continuación: 
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protected void btConsultarNota_Click(object sender, EventArgs e) 


( 
// Obtener datos de los controles del formulario 
int idAlum = Convert.Tolnt32(ctDni.Text); 





int idAsig = Convert.Tolnt32(IsdAsignatura.Selectedltem.Value); 


// Crear el contexto de objetos 


bd_notasAlumnosEntities contex0bj = new bd_notasAlumnosEntities(); 
// Consulta para obtener el nombre de idAlum y su nota en idAsig 





var consulta = from alum in contex0bj.alumnos 
from al_as in alum.alums_asigs 
where al_as.id_alumno == idAlum 84 
al_as.id_asignatura == idAsig 
select new { alum.nombre, al_as.nota }; 








try 


// Ejecutar la consulta y obtener los datos 
if (consulta.Count() != 0) 
( 
foreach (var alum in consulta) 
( 
// Mostrar en la página el nombre y la nota 
etNombre.Text = "Nombre: " + alum.nombre; 
etNota.Text = "Nota: " + alum.nota; 
etError.Text = ""; 
) 
) 
else 
( 
// El alumno buscado no se encontró 
etNombre.Text = ""; 
etNota.Text = ""; 
etError.Text = "Error: no está en acta"; 
) 
) 
catch (Exception exc) 
( 
etError.Text = "Error: 
) 


+ exc.Message; 


} 


Una alternativa a esta solución es prescindir de los métodos Page_Load (ini- 
cia la etiqueta etError con una cadena vacía) y btConsultarNota_Click de la clase 
FormWebNotas, así como de las etiquetas e£Nombre, etNota y etError, y añadir 
en su lugar un nuevo control de tipo DetailsView, por ejemplo, que muestre los 
datos nombre y nota obtenidos de otro objeto EntityDataSource que realice la 
consulta anterior con los parámetros ctDni. Text y IsdAsignatura.Selectedltem. Va- 
lue. Dejamos esta alternativa para el apartado de Ejercicios propuestos. 
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Generar la consulta Select mediante código 


Otra característica interesante de este control es poder programar consultas inde- 
pendientemente de las que nos permite el asistente. Al igual que sucede con los 
controles SqlDataSource y ObjectDataSource, la manera de realizar este tipo de 
consultas es interceptando el evento Selecting del control. Ahora bien, EntityDa- 
taSource no es un control basado en LINQ, sino en Entity SQL. Por eso, no dis- 
ponemos para este control de una programación LINQ externa. Por lo tanto, si 
necesitamos utilizar LINQ para realizar consultas sobre las entidades del modelo 
de datos (LINO to Entities), por ejemplo: 


protected void FuenteDeDatosEDS_Selecting(object sender, 
EntityDataSourceSelectingEventArgs e) 
( 
int idAsig = 20590; 
// Contexto de objetos 
bd_notasAlumnosEntities contexDeDatos = 
new bd_notasAlumnosEntities(); 
// Consulta 
var consulta = from asig in contexDeDatos.asignaturas 
where asig.id_asignatura == idAsig 
select asig; 
e.Result = consulta; // no existe una propiedad Result, 
// como en LinqDataSource, que permita devolver el resultado. 





al menos en esta versión, no es posible: tendríamos que recurrir al control Object- 
DataSource. No obstante, podemos utilizar el evento Selecting de EntityData- 
Source para construir la consulta después de que se produzca este evento, 
sabiendo que la propiedad DataSource del objeto que encapsula los datos del 
evento (objeto EntityDataSourceSelectingEventArgs) hace referencia al control 
EntityDataSource que generó el evento. Por ejemplo, partiendo de la siguiente 
configuración de FuenteDeDatosEDS: 


<asp:EntityDataSource ID="FuenteDeDatosEDS" runat="server" 
ConnectionString="name=bd_notasAlumnosEntities"” 
DefaultContainerName="bd_notasAlumnosEntities" 
EntitySetName="asignaturas" 
Select="it.[id_asignatura], ¡it.[nombre]" 
onselecting="FuenteDeDatosEDS_Selecting" 
Where="1t.id_asignatura == (id_asignatura"> 

eters> 

<asp:Parameter Name="1d_asignatura" Type="Int32" /> 

</WhereParameters> 

</asp:EntityDataSource> 
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podemos implementar el controlador del evento Selecting para que la consulta se 
filtre en función del valor de TextBoxl: 


protected void FuenteDeDatosEDS_Selecting(object sender, 
EntityDataSourceSelectingEventArgs e) 

( 
e.DataSource.WhereParameters["id_asignatura"].DefaultValue = 


El evento Selecting se genera antes de que se ejecute la operación Select del 
control, prevaleciendo así la consulta programada en el controlador de dicho 
evento sobre Select. Este evento solo se genera si el control EntityDataSource 
detecta que la consulta va a generar un resultado diferente al ya existente, por 
ejemplo, porque en el método anterior TextBox1.Text cambia, lo cual exigiría ob- 
tener del formulario el valor de este identificador y parametrizar la consulta 
HTML como se ve a continuación: 


<asp:EntityDataSource ID="FuenteDeDatosEDS" runat="server" 
ConnectionString="name=bd_notasAlumnosEntities” 
DefaultContainerName="bd_notasAlumnosEntities" 
EntitySetName="asignaturas" 
Select="it.[id_asignatura], it.[nombre]" 
onselecting="FuenteDeDatosEDS_Selecting" 
Where="1t.id_asignatura == (id_asignatura"> 
<WhereParameters> 
<asp:ControlParameter ControlID="TextBox1" 
Name="1d_asignatura” PropertyName="Text" Type="Int32" /> 
</WhereParameters> 
</asp:EntityDataSource> 








La parametrización es necesaria cuando se desea comparar un valor de pro- 
piedad con un valor que solo se conoce durante la ejecución. Para aplicarla, el 
control EntityDataSource contiene las colecciones de parámetros siguientes: 
CommandParameters, DeleteParameters, InsertParameters, OrderByPara- 
meters, SelectParameters, UpdateParameters y WhereParameters. 


Realizar cambios en los datos 


El control EntityDataSource permite especificar tanto tareas de recuperación 
propias de una base de datos (seleccionar, agrupar y ordenar) para una colección 
de datos en memoria o un objeto que represente datos de una base de datos, como 
tareas de modificación (actualizar, eliminar e insertar) para tablas de base de da- 
tos, pero a diferencia de los controles SqlDataSource y ObjectDataSource, el 
control EntityDataSource puede crear dinámicamente las órdenes para seleccio- 
nar, actualizar, insertar y eliminar datos. Por ejemplo, con SqlDataSource, hay 
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que establecer explícitamente las propiedades SelectCommand, UpdateCom- 
mand, InsertCommand y Delete Command en consultas SQL. Sin embargo, con 
el control EntityDataSource no tiene que establecer explícitamente estas órde- 
nes, porque este control a través del proveedor de LINQ puede crearlas automáti- 
camente (véase el apartado Realizar cambios en los datos en el capítulo LINO). 
Veamos un ejemplo. 


Actualizar y eliminar filas en la base de datos 


Continuando con la aplicación anterior, vamos a implementar las operaciones 
de actualizar y eliminar filas de cualquiera de las tablas. Para ello, vamos a añadir 
un nuevo formulario denominado ActualizarEliminar.aspx y colocamos sobre él 
un control EntityDataSource, EntityDataSourcel, y otro ListView, ListViewl. 


Configuramos el control EntityDataSourcel para programar una consulta que 
nos devuelva la tabla alums_asigs permitiendo, además, que el control EntityDa- 
taSourcel pueda realizar operaciones de actualización y eliminación de forma au- 
tomática, según muestra la figura siguiente. Finalizada la configuración, cierre el 
diálogo haciendo clic en Finalizar. 





r = 
Configurar origen de datos - EntityDataSourcel L ES 


«y Configurar selección de datos 





EntitySetName: 





alums_asigs x | 





EntityTypeFilter: 





(Ninguno) z] 





Elija las propiedades en el resultado de la consulta: 





Y] Seleccionar todo (valor de entidac 
id_alumno 
id_asignatura 

7] nota 





F] Habilitar inserciones automáticas 


[Y] Habilitar actualizaciones automáticas 





latir eliminaciones automáticas 


< Anterior Finalizar | | Cancelar 


























Las operaciones anteriores se traducen en el siguiente código HTML: 


<asp:EntityDataSource ID="EntityDataSourcel" runat="server" 
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ConnectionString="name=bd_notasAlumnosEntities" 

DefaultContainerName="bd_notasAlumnosEntities" 

EnableDelete="True" EnableUpdate="True" 

EntitySetName="alums_asigs"> 
</asp:EntityDataSource> 


En este punto, el control EntityDataSourcel está vinculado con los datos y 
listo para ser vinculado al control ListViewl; así que seleccionamos este control y 
lo configuramos para que su origen de datos sea EntityDataSourcel y permita las 
operaciones de edición, eliminación y paginación. Después, desde la vista de có- 
digo HTML eliminamos de todas las plantillas de ListView1 las columnas alumno 
y asignatura, ya que se corresponden con las propiedades de la entidad alum_asig 
que definen las relaciones entre las tablas. 


Repita el proceso descrito para las otras dos tablas, esto es, coloque y configu- 
re sobre el mismo formulario un control EntityDataSource y otro ListView por 
cada una de las tablas. Finalmente, puede utilizar el control HyperLink para na- 
vegar de una página a otra. Por ejemplo, para navegar a la página principal: 


<asp:HyperLink ID="HyperLink4" runat="server" 
NavigateUrl="Default.aspx">Volver 

</asp:HyperLink> 

<br /><br /> 


El resultado final sería análogo al mostrado en la figura siguiente: 





r 





e http://localhost/EntityDataSource/ActualizarEliminar.asp 








Volver 


ID alumnoID asignatura Nota 






























































Eliminar || Editar [1234560 34680 4,5 
Eliminar || Editar [1234561 20591 253 
Eliminar || Editar [1234561 30215 6,5 
Eliminar || Editar [1234561 32346 vis 
Eliminar || Editar [1234561 33693 7,5 
Eliminar Editar [1234562 20591 9,5 
Eliminar || Editar [1234562 30215 TS 
Eliminar || Editar [1234562 31970 4,5 
Eliminar Editar [1234562 33693 207 
Eliminar || Editar [1234563 30215 P3 

















Primera Anterior Siguiente Última 

















Volver 


ID alumno Nombre 
Eliminar || Editar [1234560 Alberto García Sánchez 
Eliminar || Editar [1234561 Isabella Dulce Bella 
Eliminar || Editar [1234562 Luis Gonzalez Arrutia 
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Añada también el siguiente código a Default.aspx para poder navegar a la pá- 
gina Actualizar o eliminar: 


<asp:HyperLink ID="HyperLink1" runat="server" 
NavigateUrl="ActualizarEliminar.aspx"> 
Actualizar o eliminar 
</asp:HyperLink> 


Controlar los errores en una página ASP.NET 


Recuerde que Entity Framework no admite operaciones de eliminación en 
cascada. Por lo tanto, si desea eliminar una fila de una tabla que tiene restriccio- 
nes, deberá eliminar primero los objetos secundarios que impiden que se elimine 
el objeto primario. Para detectar este tipo de errores, podemos añadir a la página 
ActualizarEliminar.aspx el siguiente método: 


protected void Page_Error(object sender, EventArgs e) 
( 
Exception objError = Server.GetLastError().GetBaseException(); 


string mensajeError = "<h3>Error: </h3><hr><br>" + 
objError.Message.ToString() + 
"<br><br><a href="ActualizarEliminar.aspx*>Volver</a>"; 
Response .Write(mensajeError.ToString()); 
Server.ClearError(); 


ASP.NET proporciona tres formas de capturar y responder a los errores que 
se pueden producir al ejecutar una aplicación: mediante los eventos Page Error y 
Application_Error, y mediante el fichero de configuración de la aplicación 
Web.config. El primero permite capturar los errores que se producen en la página, 
el segundo, los que se producen en la aplicación, y el tercero permite controlarlos 
configurando la sección <customErrors> del fichero Web.config en la que puede 
especificar una página de redirección como página de errores predeterminada (de- 
faultRedirect) o especificar una página concreta. 


En el ejemplo anterior hemos utilizado el evento Page_Error para enviar por 
medio de una página HTML un mensaje al usuario indicando el error ocurrido. 
Observe que al final del código se hace una llamada a Server.ClearError para 
impedir que el error continúe al evento Application_Error para ser tratado. 


Insertar filas en la base de datos 
Continuando con la aplicación, vamos a implementar la operación de insertar 


filas en cualquiera de las tablas. Para ello, vamos a añadir un nuevo formulario 
denominado I/nsertar.aspx y colocamos sobre él un control EntityDataSource, 
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EntityDataSource3, y otros controles necesarios para capturar los datos de una fi- 
la. 


Por ejemplo, supongamos que deseamos insertar una fila en la tabla 
alums_asigs. En este caso hay que tener presente que la nueva fila tiene que estar 
relacionada con una fila de la tabla alumnos y con otra de la tabla asignaturas, eso 
es lo que indican las propiedades alumno y asignatura de la entidad alum_asig. 
Por lo tanto, esas filas deben existir, de lo contrario no se podrían construir las re- 
laciones y se produciría un error. Para obtener estos datos, vamos a colocar sobre 
el formulario dos controles EntityDataSource más, EntityDataSourcel y Enti- 
tyDataSource2, los cuales vincularemos con otros dos controles DropDownList, 
DropDownListl y DropDownList2, para que nos permitan obtener el alumno y la 
asignatura que formarán parte de las relaciones. En definitiva, lo que estamos ha- 
ciendo es matricular a un alumno de una asignatura (la nota la iniciaremos con un 
valor cero). 


Configuramos el control EntityDataSourcel para programar una consulta que 
nos devuelva la tabla alumnos y el control EntityDataSource2 para programar una 
consulta que nos devuelva la tabla asignaturas. Después configuramos el control 
EntityDataSource3 para programar una consulta que nos devuelva la tabla 
alums_asigs permitiendo, además, que el control EntityDataSource3 pueda reali- 
zar Operaciones de inserción de forma automática, según muestra la figura si- 
guiente. Finalizada la configuración, cierre el diálogo haciendo clic en Finalizar. 





Configurar origen de datos - EntityDataSource3 L (esas) 


«y Configurar selección de datos 





EntitySetName: 





alums_asigs xj 





EntityTypeFilter: 





(Ninguno) z] 





Elija las propiedades en el resultado de la consulta: 





Y] Seleccionar todo (valor de entidac 
id_alumno 
id_asignatura 

F] nota 





[Y] Habilitar inserciones automáticas 
E| Habilitar actualizaciones automáticas 


] Habilitar eliminaciones automáticas 





< Anterior Finalizar | | Cancelar 
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Las operaciones anteriores se traducen en el siguiente código HTML: 


<asp:EntityDataSource ID="EntityDataSourcel" runat="server" 
ConnectionString="name=bd_notasAlumnosEntities” 
DefaultContainerName="bd_notasAlumnosEntities" 
EntitySetName="alumnos"> 

</asp:EntityDataSource> 


<asp:EntityDataSource ID="EntityDataSource2" runat="server" 
ConnectionString="name=bd_notasAlumnosEntities" 
DefaultContainerName="bd_notasAlumnosEntities" 
EntitySetName="asignaturas"> 

</asp:EntityDataSource> 


<asp:EntityDataSource ID="EntityDataSource3" runat="server" 
ConnectionString="name=bd_notasAlumnosEntities” 
DefaultContainerName="bd_notasAlumnosEntities" 
EntitySetName="alums_asigs” 
</asp:EntityDataSource> 














En este punto, los controles EntityDataSource están vinculados con los datos 
y listos para ser vinculados con los controles respectivos del formulario; así que 
seleccionamos el control DropDownList1 y lo configuramos para que su origen de 
datos sea EntityDataSourcel y DropDownList2 lo vinculamos con EntityData- 
Source2. Estas operaciones se traducen en el siguiente código HTML: 


<asp:DropDownList ID="DropDownListl1" runat="server" 
DataSourcelD="EntityDataSourcel" DatalextField="nombre" 
DataValueField="1d_alumno" Width="250px"> 

</asp:DropDownList> 


<asp:DropDownList ID="DropDownList2" runat="server" 
DataSourcelD="EntityDataSource2" DatalextField="nombre" 
DataValueField="id_asignatura" Width="250px"> 
</asp:DropDownList> 











Si ahora ejecuta la aplicación, observará que las listas desplegables le permiti- 
rán elegir el alumno y la asignatura de la cual este se quiere matricular. Una vez 
seleccionados estos datos, necesitamos un botón, btMatricular, que permita inser- 
tar la nueva fila en la tabla alums asigs y una etiqueta, etMsj, que muestre el 
mensaje correspondiente al éxito o no de la operación. 


Este proceso no resulta tan directo como sucede con el control LinqData- 
Source (control más limitado en prestaciones que EntityDataSource) ya que En- 
tityDataSource no proporciona un método Insert. Es por lo que vamos a utilizar 
el método Insert de EntityDataSourceView. Este método genera el evento In- 
serting antes de que se ejecute la operación de insertar. 
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Cualquier clase que implemente la interfaz IDataSource es un control de ori- 
gen de datos, aunque la mayoría de estos controles se derivan de la clase abstracta 
DataSourceControl, la cual proporciona una implementación base de esta inter- 
faz. Un ejemplo es el control EntityDataSource; este control tiene un atributo 
privado de tipo EntityDataSourceView que es devuelto por el método protegido 
GetView (accederemos a este método a través de la interfaz IDataSource que lo 
proporciona) que representa la vista del control EntityDataSource para el que es 
invocado el método. EntityDataSourceView, que se deriva de DataSourceView, 
proporciona una interfaz que permite realizar operaciones sobre los datos que el 
objeto DataSourceView representa. 


EntityDataSourceView vista = (origenDeDatos as IDataSource).GetView( 
string.Empty) as EntityDataSourceView; 
vista.InsertínuevaFila, Finalizacion); 


El primer parámetro de Insert es un objeto que implementa la interfaz IDic- 
tionary que almacena los pares columna-valor de la fila a insertar, y el segundo 
parámetro es un delegado o un método de devolución de llamada con la misma 
firma que el delegado DataSourceViewOperationCallback que se pasa a la vista 
para poder notificar al control enlazado a datos la finalización de la operación de 
Insertar. 


private static bool Finalizacion(int filasAfectadas, Exception exc) 
( 
return false; // indica que las excepciones no se han manipulado 


} 


El método utiliza dos parámetros: uno para devolver el número de registros 
que se han visto afectados y otro para devolver la excepción en el caso de que se 
produzca una durante el procesamiento de la operación de datos. 


Para hacer transparente todo este proceso en torno a Insert, vamos a ampliar 
la clase EntityDataSource con un método extensor Insert que nos permita susti- 
tuir las líneas de código anterior por esta otra: 


EntityDataSource3.Insert(nuevaFila); 


Para ello, añada a la aplicación la clase EntityDataSourceEx con dos sobre- 
cargas del método Insert según se muestra a continuación: 


using System.Collections.Specialized; 

using System.Collections; 

/// <summary> 

/// EntityDataSourceEx: clase que amplía EntityDataSource 
/// mediante métodos extensores: Insert. 

/// </summary> 
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namespace System.Web.UI.Weblontrols 


( 


public static class EntityDataSourceEx 


( 


private static bool Finali 
( 
return false; // indica 


) 


public static void Insertí 
( 
// Llamada: origen.Inser 
EntityDataSourceView vis 
string.Empty) as Entit 

// Insertar la fila en a 
vista.Insertínew ListDic 





) 





public static void Insertí 
IDictionary nuevaFila) 
( 
// Llamada: origen.Inser 
EntityDataSourceView vis 
string.Empty) as Entit 
// Insertar la fila en a 
vista.Insert(nuevaFila, 


zacion(int filasAfectadas, Exception exc) 


que las excepciones no se han manipulado 


this EntityDataSource origenDeDatos) 


t() --> evento Inserting 

ta = (origenDeDatos as IDataSource).GetView( 
yDataSourceView; 

lums_asigs 

tionary(), Finalizacion); 


this EntityDataSource origenDeDatos, 


t(objetolDictionary) --> evento Inserting 

ta = (origenDeDatos as IDataSource).GetView( 
yDataSourceView; 

lums_asigs 

Finalizacion); 








La segunda sobrecarga del método Insert permitirá implementar un controla- 
dor para el evento Click del botón btMatricular así: 


protected void btMatricular_Click(object sender, EventArgs e) 


( 


try 


( 


) 


etMsj.Text = ""; 


// Colección columma-valor para el método Insert 


ListDictionary nuevaFil 
// Valores de la fila 


a = new ListDictionary(); 


nuevaFila.Add("id_alumno", DropDownListl.SelectedValue); 
nuevaFila.Add("id_asignatura", DropDownList2.SelectedValue); 
nuevaFila.Add("nota", 0.0F); 





// Insertar la fila en 


alums_asigs 


EntityDataSource3.Insertí(nuevaFila); 


etMsj.Text = "Matrícula 


catch (Exception exc) 


( 


realizada."; 
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string msjError = "Ya está matriculado en esta asignatura " + 
"(clave duplicada)"; 
etMsj.Text = msjError; 
) 
) 


Y la primera sobrecarga del método /nsert requerirá implementar, además, un 
controlador para el evento Inserting de EntityDataSource3 generado antes de la 
operación de inserción: 


protected void btMatricular_Click(object sender, EventArgs e) 
( 
try 
( 
etMsj.Text = ""; 
// Insertar la fila en alums_asigs 
EntityDataSource3.Insert(); 
etMsj.Text = "Matrícula realizada."; 
) 
catch (Exception exc) 
( 
string msjError = "Ya está matriculado en esta asignatura " + 
"(clave duplicada)"; 
etMsj.Text = msjError; 
) 
) 





protected void EntityDataSource3_Inserting(object sender, 
EntityDataSourceChangingEventArgs e) 
{ 

// Nueva entidad alums_asigs 

var nuevo = e.Entity as alum_asig; 

nuevo.id_alumno = Convert.Tolnt32(DropDownListl1.SelectedValue); 

nuevo.id_asignatura = Convert.ToInt32(DropDownList2.SelectedValue); 

nuevo.nota = 0.0F; 

// Establecer las relaciones con idAlum e idAsig 

int idAlum = Convert.ToInt32(DropDownList1l.SelectedValue); 

int idAsig = Convert.ToInt32(DropDownList2.SelectedValue); 

// Establecer referencias 

object alum; 

e.Context.TryGetO0bjectByKey(new System.Data.EntityKkKey( 
"bd_notasAlumnosEntities.alumnos”, "id_alumno", idAlum), 
out alum); 

nuevo.alumno = (alumno)alum; 

object asig; 

e.Context.TryGetO0bjectBykKey(new System.Data.EntityKkKey( 
"bd_notasAlumnosEntities.asignaturas", "id_asignatura", 
idAsig), out asig); 

nuevo.asignatura = (asignatura)asig; 
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Si ahora ejecuta la aplicación, obtendrá una página análoga a la siguiente: 





Py 





























i caia 
a e http://localhost/E P ~ EC | E matricular | y 
Matricular: 
Isabella Dulce Bella v] 
PROGRAMACION AVANZADA v 
Matricular 

Ya está matriculado/a en esta asignatura (clave duplicada) 
Volver 

x e 

















Repita un proceso análogo al descrito para las otras dos tablas (páginas Agre- 
garÁAlumno y AgregarAsignatura). Esta aplicación, puede obtenerla de la carpeta 
Capl6EntityDataSource2 del CD correspondiente al libro. 


MODELO DE ENLACE DE ASP.NET 


Según estudiamos en el capítulo ASP.NET, el modelo de enlace de ASP.NET 
permite que la interacción con los datos sea totalmente controlada por el desarro- 
llador, cosa que los objetos orígenes de datos que acabamos de estudiar no permi- 
ten cuando la conexión con el origen de datos se hace en HTML. También, 
dependiendo del escenario en el que estemos trabajando, esto podría lograrse es- 
tableciendo la propiedad DataSource del control y llamando a continuación a su 
método DataBind, pero esto no funciona bien con controles ricos en datos, como 
DataGrid, que soportan operaciones automáticas como la ordenación, paginación 
y edición. Resumiendo, el modelo de enlace de ASP.NET pretende simplificar el 
trabajo con código orientado a la lógica de acceso a datos al mismo tiempo que 
conserva un marco de trabajo rico en datos, con enlaces en las dos direcciones. 


Este patrón funciona con cualquier tecnología de acceso a datos como EF, 
NHibernate, conjuntos de datos ADO.NET, etc.; nosotros utilizaremos EF. 


S1 recuerda, en el capítulo ASP.NET vimos que a partir de un control de ser- 
vidor enlazado a datos, como GridView, ListView, DetailsView, FormView o 
DropDownList, podíamos especificar los nombres de los métodos a utilizar para 
la selección, actualización, eliminación y creación de datos, a través de sus pro- 
piedades SelectMethod, UpdateMethod, DeleteMethod e InsertMethod (no to- 
das las propiedades están presentes en todos los controles mencionados) y dentro 
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de esos métodos utilizábamos la tecnología de acceso de datos, por ejemplo Entity 
Framework, para ejecutar las operaciones de datos requeridas. Vimos también que 
en los métodos correspondientes a UpdateMethod e InsertMethod había que in- 
vocar al método TryUpdateModel para recuperar automáticamente los valores 
enlazados del formulario web al modelo de datos. 


También, este modelo de enlace aporta una serie de atributos proveedores de 
valores (value provider attributes) para especificar el origen de un valor determi- 
nado. Estos atributos se encuentran en el espacio de nombres System.Web.Mo- 
delBinding y son: Control, Cookie, Form, Profile, QueryString, RouteData, 
Session y ViewState. 


Por ejemplo, Control especifica valores para el modelo de enlace proporcio- 
nados por un control: 


public object ObtenerNota([Control("ctDni", "Text")] int? idAlum, 
[Control("IsdAsignatura", "SelectedValue")] int? ¡idAsig) 

( 
/1 

) 


En este ejemplo se puede observar que el método ObtenerNota tiene dos pa- 
rámetros de tipo int? (el ? indica que esos parámetros pueden contener el valor 
null). Cuando el formulario sea enviado al servidor para ser procesado y el méto- 
do ObtenerNota sea invocado, en el instante que le corresponda durante el ciclo 
de vida de dicho formulario, el modelo de enlace obtendrá el valor de la propiedad 
Text del control ctDni y lo asignará al parámetro ¡dAlum y obtendrá el valor de la 
propiedad SelectedValue del control /sdAsignatura y lo asignará al parámetro 
idAsig (las conversiones entre tipos son automáticas). 


Análogamente, QueryString especifica valores para el modelo de enlace pro- 
porcionados por la cadena de consulta (la URL). Por ejemplo: 


public IQueryable<asignatura> ObtenerAsignatura(l 
[QueryString] int? idAsignatura) 

( 
/1 

) 


En este ejemplo se puede observar que el método ObtenerAsignatura tiene un 
parámetro idAsignatura. Entonces, si en la cadena de consulta hay un parámetro 
con ese nombre (idAsignatura), el modelo de enlace obtendrá ese valor y lo asig- 
nará al parámetro. 
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El resto de los atributos se explican de forma análoga, esto es, el modelo de 


enlace obtendrá el valor de una cookie, de un campo de un formulario, de un per- 
fil, de los datos de la ruta (Page. RouteData), de la sesión o del estado de vista. 


Como ejemplo, vamos a reproducir la aplicación anterior pero utilizando aho- 


ra el modelo de enlace de ASP.NET en lugar de controles de servidor orígenes de 
datos (puede obtenerla de la carpeta Cap16lModeloDeEnlaceASPNET del CD co- 
rrespondiente al libro). Los pasos a seguir son los siguientes: 


1. 


Cree un nuevo sitio web denominado ModeloDeEnlaceASPNET. Añada un 
formulario web al sitio. 


Diseñe la interfaz gráfica arrastrando los controles correspondientes desde la 
caja de herramientas a la superficie de diseño. Básicamente, utilizaremos un 
TextBox para que el usuario escriba el DNI, un DropDownList para mostrar 
la lista de asignaturas, un Button para enviar la consulta, un DetailsView para 
mostrar el nombre y la nota correspondientes a los datos seleccionados, un 
Label para mostrar mensajes al usuario y controles HyperLink para navegar 
entre páginas. 





Default.aspx.cs Defaultaspx ® X 


+ Mensaje de error 1. 











DNI: | * + Mensaje de error 2. 
Sin enlazar y] 
Consultar nota 
Nombre DataBound 
Nota DataBound 


Error: 


Actualizar o eliminar  Matricular Agregar alumno Agregar asignatura 





Implemente el modo de validación discreto necesario para los controles de va- 
lidación según explicamos anteriormente en el apartado Controles de valida- 
ción. 


Abra el explorador de bases de datos/explorador de servidores y añada una 
conexión a la base de datos bd_notasAlumnos. 


Agregue un nuevo elemento de tipo ADO.NET Entity Data Model al proyecto 
para abrir el asistente para el EDM, póngalo en la carpeta App_Code del pro- 
yecto. Genere el modelo desde las tablas alumnos, alums_asigs y asignaturas 
de la base de datos bd_notasAlumnos. Denomine al contexto de objetos 
bd_notasAlumnosContexto. Para más detalles véase el capítulo LINO. 


868 ENCICLOPEDIA DE MICROSOFT VISUAL CH 


6. El resto de la implementación será análogo a lo que ya hicimos cuando utili- 
zábamos el control EntityDataSource, pero utilizando ahora las propiedades 
adecuadas entre SelectMethod, UpdateMethod, DeleteMethod e Insert- 
Method de los controles de acceso a datos de la página web, para especificar 
qué métodos ejecutarán las operaciones de selección, actualización, elimina- 
ción o creación de datos, las necesarias en cada caso, sobre el contexto 
bd_notasAlumnosContexto. 


Siguiendo con la aplicación, vamos a configurar la lista desplegable /sdAsig- 
natura para que pueda obtener del contexto de objetos la lista de asignaturas y sus 
identificadores. Para ello, estando en la ventana de diseño, no tiene nada más que 
seleccionar la lista y establecer las propiedades especificadas a continuación desde 
la ventana de propiedades: 


<asp:DropDownList ID="lsdAsignatura" runat="server" 
Itemlype="asignatura" 
DatalextField="nombre" 
DataValueField="id_asignatura" 
SelectMethod="0btenerAsignaturas" > 
</asp:DropDownList> 





La propiedad ItemType, opcional, especifica la clase que define el tipo de los 
objetos que se van a enlazar, en este caso objetos de tipo asignatura, DataText- 
Field especifica el campo de la clase asignatura que proporciona el contenido que 
mostrarán los elementos de lista, DataValueField se refiere al campo de asigna- 
tura que proporciona el valor para cada elemento de lista y SelectMethod alma- 
cena el nombre del método que ejecutará la consulta sobre el contexto de objetos 
para obtener y devolver los objetos asignatura que poblarán la lista desplegable. 
Por lo tanto, este método lo escribiremos en el fichero de código subyacente de 
esta página así: 


public IQueryable<asignatura> ObtenerAsignaturas() 

( 
bd_notasAlumnosContexto bd = new bd_notasAlumnosContexto(); 
var consulta = bd.asignaturas; 
return consulta; 


} 


Como ya dijimos, la interfaz IQueryable<T> está pensada para evaluar con- 
sultas con respecto a un origen de datos. Esta interfaz hereda de IEnumera- 
ble<T>, por lo que si representa una consulta, se puede iterar por los resultados de 
esa consulta, lo cual fuerza la ejecución del árbol de expresión asociado a un obje- 
to IQueryable<7>. 
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Si ahora ejecuta la aplicación, observará que la lista se llena con los nombres 
de las asignaturas. Si no es así y lo que se visualiza es un error de que no se puede 
abrir la base de datos solicitada porque la conexión para el usuario NT AUTHO- 
RITY Servicio de Red falla, es porque el usuario mencionado no tiene permisos 
para acceder a la base de datos. En este caso proceda como se explicó en el apar- 
tado Obtener acceso a la base de datos anteriormente en este mismo capítulo. 


La finalidad de la aplicación es mostrar la nota de la asignatura seleccionada 
para el alumno identificado por su DNI. Por eso, cuando el alumno haya introdu- 
cido estos datos, hará clic en el botón Consultar nota, instante en el que la página 
será enviada al servidor. ASP.NET, siguiendo el ciclo de vida de la página, anali- 
zará por cada uno de los controles qué operaciones tiene que realizar. Entonces, si 
existiera un método capaz de seleccionar los datos para poblar el control Details- 
View, lo ejecutaría. Por ello, vamos a configurar este control así: 


<asp:DetailsView ID="DetailsViewl1" runat="server" 
AutoGenerateRows="False" 
onprerender="DetailsViewl_PreRender" 
SelectMethod="0btenerNota" > 
<Fields> 
<asp:BoundField DataField="nombre" HeaderText="Nombre" /> 
<asp:BoundField DataField="nota" HeaderText="Nota" /> 
</Fields> 
</asp:DetailsView> 





El control DetailsView se utiliza para mostrar un registro de un origen de da- 
tos en una tabla; cada campo del registro aparece en una fila de la tabla. Por ejem- 
plo, es útil para utilizarlo en combinación con un control GridView en los 
escenarios maestro-detalle. 


En el código anterior se puede observar que la propiedad SelectMethod indi- 
ca que los datos que debe mostrar el control DetailsView tienen que ser seleccio- 
nados y devueltos por el método ObtenerNota. Este método tendría que buscar la 
nota de la asignatura seleccionada por el alumno que se ha identificado. Para ello, 
creará el objeto contexto de objetos necesario para interactuar con el modelo de 
objetos representativo de la base de datos, y, utilizando como parámetros el iden- 
tificador del alumno (ctDni.Text) y el de la asignatura (IsdAsignatura.Selected- 
Value), realizará una consulta que a continuación procesará con el fin de obtener 
el registro correspondiente y devolverlo para que sea mostrado por el control De- 
tailsView. El código correspondiente al proceso descrito puede ser así: 


public object ObtenerNota([Control("ctDni", "Text")] int? idAlum, 
[Control("IsdAsignatura", "SelectedValue")] int? idAsig) 

( 
if (!IsPostBack) return null; 
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if (lidAlum.HasValue || !idAsig.HasValue) return null; 
bd_notasAlumnosContexto bd = new bd_notasAlumnosContexto():; 
// Consulta para obtener el nombre de idAlum y su nota en idAsig 
var consulta = from alum in bd.alumnos 
from al_as in alum.alums_asigs 
where al_as.id_alumno == idAlum 44 
al_as.id_asignatura == idAsig 
select new { alum.nombre, al_as.nota }; 
return consulta.ToList(); 





Realizar cambios en los datos 


Algunos de los controles de acceso a datos, como el FormView o el DataGrid, 
según vimos en el capítulo ASP.NET, permiten no solo seleccionar datos de una 
base de datos, sino actualizarlos, eliminarlos o insertarlos. Basta con que especifi- 
quen los métodos que realizarán tales operaciones. 


Actualizar y eliminar filas en la base de datos 


Continuando con la aplicación anterior, vamos a implementar las operaciones 
de actualizar y eliminar filas de cualquiera de las tablas. Para ello, vamos a añadir 
un nuevo formulario denominado ActualizarEliminar.aspx y colocamos sobre él 
un control ListView, ListView!l. 


A continuación, configuramos el ListView] para que pueda obtener del con- 
texto de objetos el contenido de la tabla alums asigs de la base de datos. Para 
ello, estando en la ventana de diseño, no tiene nada más que seleccionar este con- 
trol, establecer las propiedades especificadas a continuación desde la ventana de 
propiedades y habilitar las operaciones de edición, eliminación y paginación (tru- 
co: puede añadir, solo para configurar el ListView, un control EntityDataSource 
como origen de datos y eliminarlo una vez configurado automáticamente el List- 
View): 


<asp:ListView ID="ListViewl" runat="server" 
ItemType="alum_asig" 
DataKeyNames="id_alumno,id_asignatura" 
SelectMethod="0btenerNotas"> 
UpdateMethod="ModificarNotas" 
DeleteMethod="BorrarNotas" > 





</asp:ListView> 


La propiedad SelectMethod almacena el nombre del método, ObtenerNotas, 
que ejecutará la consulta sobre el contexto de objetos para obtener y devolver los 
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objetos alum_asig que poblarán este ListView!. Por lo tanto, este método lo escri- 
biremos en el fichero de código subyacente de esta página así: 


public IQueryable<alum_asig> ObtenerNotas() 

( 
bd_notasAlumnosContexto bd = new bd_notasAlumnosContexto():; 
var consulta = bd.alums_asigs; 
return consulta; 


} 


La propiedad UpdateMethod almacena el nombre del método, ModificarNo- 
ta, que obtendrá del contexto de objetos la entidad identificada por los parámetros 
id_alumno e id_ asignatura, actualizará (TryUpdateModel) esta entidad con los 
datos modificados en el ListView] y salvará los cambios en la base de datos. Por 
lo tanto, este método podemos escribirlo así: 


public void ModificarNota(int id_alumnmo, int id_asignatura) 
( 
using (bd_notasAlumnosContexto bd = new bd_notasAlumnosContexto()) 
( 
// Cargar el elemento 
alum_asig objAlAs = bd.alums_asigs.Find(id_alummo, id_asignatura); 
if (objAlAs == null) return; 
TryUpdateModel(objAlAs); 


if (ModelState.IsValid) 
( 





// Guardar los cambios 
bd.SaveChanges():; 
) 


La propiedad DeleteMethod almacena el nombre del método, BorrarNota, 
que invoca al método Entry para obtener el objeto DbEntityEntry que hace el 
seguimiento de la entidad identificada por los parámetros id_alumno e id_asigna- 
tura para marcarla como eliminada. Los cambios, en este caso borrar la entidad 
marcada como eliminada, serán ejecutados cuando se invoque al método Save- 
Changes del contexto de objetos. Según lo expuesto, podemos escribir este méto- 
do así: 


public void BorrarNota(int id_alumno, int id_asignatura) 
( 
using (bd_notasAlumnosContexto bd = new bd_notasAlumnosContexto()) 
( 
var ObjAlAs = new alum_asig { id_alumno = id_alumno, 
id_asignatura = id_asignatura):; 
bd.Entry(objAlAs).State = System.Data.EntityState.Deleted; 
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bd.SaveChanges():; 


) 


// Si error ==> Page_Error 


Repita el proceso descrito para las otras tablas, esto es, coloque sobre el mis- 
mo formulario otro ListView por cada una de las otras dos tablas y configúrelos 
para que invoquen a los métodos que lleven a cabo las operaciones de selección, 


actualización y borrado. 


Finalmente, puede utilizar el control HyperLink para navegar de una página 
a otra. Por ejemplo, para navegar a la página principal: 


<asp:HyperLink ID="HyperLink4" runat="server" 
NavigateUrl="Default.aspx">Volver 


</asp:HyperLink> 
<br /><br /> 


El resultado final sería análogo al mostrado en la figura siguiente: 
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a ) (Æ http://localhost/ModeloDeEnlaceASPNET/ActualizarEliminar.asp» 
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ID alumnoID asignatura Nota 


1234560 20590 0 

1234560 33693 0 

1234561 20591 2,5 
1234561 30215 6,5 
1234561 32346 10 
1234561 33693 LO 
1234562 20591 9,3 
1234562 30215 7,3 
1234562 31970 4,5 
1234562 33693 59 


Anterior Última 





ID alumno Nombre 
1234560 Alberto García Sánchez 
1234561 Isabella Dulce Bella 
1234562 Luis Gonzalez Arrutia 


Añada también el siguiente código a Default.aspx para poder navegar a la pá- 
gina Actualizar o eliminar: 
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<asp:HyperLink ID="HyperLink1" runat="server" 
NavigateUrl="ActualizarEliminar.aspx"> 
Actualizar o eliminar 
</asp:HyperLink> 


Controlar los errores en una página ASP.NET 


Recuerde que Entity Framework no admite operaciones de eliminación en 
cascada. Por lo tanto, si desea eliminar una fila de una tabla que tiene restriccio- 
nes, deberá eliminar primero los objetos secundarios que impiden que se elimine 
el objeto primario. Para detectar este tipo de errores, podemos añadir a la página 
ActualizarEliminar.aspx el siguiente método: 


protected void Page_Error(object sender, EventArgs e) 
( 
Exception objError = Server.GetLastError().GetBaseException(); 


string mensajeError = "<h3>Error: </h3><hr><br>" + 
objError.Message.ToString() + 
"<br><br><a href="ActualizarEliminar.aspx*>Volver</a>"; 
Response .Write(mensajeError.ToString()); 
Server.ClearError(); 
) 


Insertar filas en la base de datos 


Continuando con la aplicación, vamos a implementar la operación de insertar 
filas en cualquiera de las tablas. Para ello, vamos a añadir un nuevo formulario 
denominado /nsertar.aspx y colocamos sobre él los controles necesarios para cap- 
turar los datos de una fila: 





r 





e http://localhost/ModeloDeEnlaceASPNET/Insertar.aspx 
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Matricular 


Volver 








Por ejemplo, supongamos que deseamos insertar una fila en la tabla 
alums_asigs. En este caso hay que tener presente que la nueva fila tiene que estar 
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relacionada con una fila de la tabla alumnos y con otra de la tabla asignaturas, eso 
es lo que indican las propiedades alumno y asignatura de la entidad alum_asig. 
Por lo tanto, esas filas deben existir, de lo contrario no se podrían construir las re- 
laciones y se produciría un error. Para obtener estos datos, vamos a colocar sobre 
el formulario dos controles DropDownList cuya propiedad SelectMethod hará 
referencia a los métodos ObtenerAlumnos y ObtenerAsignaturas: 


<asp:DropDownList ID="IsdAlumnos" runat="server" 
ItemType="alumno" 
DataTextField="nombre" 
DataValueField="id_alumno" 
SelectMethod="0btenerAlumnos" > 

</asp:DropDownList> 





<asp:DropDownList ID="lsdAsignaturas" runat="server" 
Itemlype="asignatura" 
DataTextField="nombre" 
DataValueField="id_asignatura" 
SelectMethod="0btenerAsignaturas" > 
</asp:DropDownList> 








La función de los métodos ObtenerAlumnos y ObtenerAsignaturas será po- 
blar las respectivas listas para que nos permitan obtener el alumno y la asignatura 
que formarán parte de las relaciones. 


public IQueryable<alumno> ObtenerAlumnos() 

( 
bd_notasAlumnosContexto bd = new bd_notasAlumnosContexto():; 
var consulta = bd.alumnos; 
return consulta; 


} 


public IQueryable<asignatura> ObtenerAsignaturas() 

( 
bd_notasAlumnosContexto bd = new bd_notasAlumnosContexto(); 
var consulta = bd.asignaturas; 
return consulta; 


} 


Si ahora ejecuta la aplicación, observará que las listas desplegables le permiti- 
rán elegir el alumno y la asignatura de la cual este se quiere matricular. Una vez 
seleccionados estos datos, necesitamos un botón, btMatricular, que permita inser- 
tar la nueva fila en la tabla alums_asigs y una etiqueta, etMsj, que muestre el 
mensaje correspondiente al éxito o no de la operación. En definitiva, lo que esta- 
mos haciendo es matricular a un alumno de una asignatura; la nota la iniciaremos 
con un valor cero. Añada, entonces, el controlador de este botón, btMatricu- 
lar_Click. ¿Qué operaciones tiene que realizar este controlador? Recuperar los 
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identificadores del alumno y asignatura seleccionados en las listas y añadir una 
nueva fila en la tabla alums_asigs que almacene estos identificadores y una nota 
inicial 0. Todo este proceso ya fue explicado en el capítulo LINQ. Apoyándonos 
en ese conocimiento, completamos el método btMatricular_ Click así: 


protected void btMatricular_Click(object sender, EventArgs e) 
( 
try 
( 
int idAlum = Convert.Tolnt32(1sdAlumnos.SelectedValue); 
int idAsig = Convert.Tolnt32(IsdAsignaturas.SelectedValue); 
Matricular(idAlum, idAsig); 
etMsj.Text = "Matrícula realizada."; 
) 
catch (Exception exc) 
( 
string msjError = "Ya está matriculado/a en esta asignatura " + 
"(clave duplicada)"; 
etMsj.Text = msjError; 
) 





} 


public void Matricular(int idAlum, int idAsig) 
{ 
using (bd_notasAlumnosContexto bd = new bd_notasAlumnosContexto()) 
{ 
// Alumno a matricular 
alumno alum = bd.alumnos.Find(idAlum); 
// Asignatura de la que se va a matricular 
asignatura asig = bd.asignaturas.Find(idAsig); 





if (alum == null || asig == null) 
( 
throw new Exception(); 


) 


// Crear un nuevo objeto alum_asig 
alum_asig al_as = new alum_asig() 
( 
id_alumno = idAlum, 
id_asignatura = idAsig, 
nota = 0.0F 
l; 


// Establecer las relaciones 

al_as.alumno = alum; // N:1 

al_as.asignatura = asig; // N:1 

// Añadir el nuevo objeto al conjunto de entidades alums_asigs 
bd.alums_asigs.Add(al_as); 
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// Enviar los cambios a la base de datos 
bd.SaveChanges():; 
) 


Si ahora ejecuta la aplicación, obtendrá una página análoga a la siguiente: 


CES 
a Xx 8 http://Iocalhost/E P-R è| (2 Matricular PENA: 



































Matricular: 
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PROGRAMACION AVANZADA v 
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Ya está matriculado/a en esta asignatura (clave duplicada) 


Volver 
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Repita un proceso análogo al descrito para las otras dos tablas (páginas Agre- 
garÁAlumno y AgregarAsignatura). Utilice para ello un control FormView que in- 
cluye la propiedad InsertMethod. 


Por ejemplo, para la página AgregarAlumno: 


<asp:FormView ID="FormViewl1" runat="server" 
Itemlype="alumno" 
DefaultMode="Insert" 
InsertMethod="InsertarAlumno" > 
<InsertItemfemplate> 


<asp:TextBox ID="ctNombre" runat="server" 
Text="<%} Bindltem.nombre %>" > 
</asp:TextBox> 


<asp:Button ID="btAgregarAl" runat="server" 
Text="Agregar alumno" 
CommandName="Insert" /> 


</Insertltemlemplate> 
</asp:FormView> 


Cuando el usuario introduzca los datos, hará clic en el botón bt4AgregarAl, se 
enviará esta página al servidor y se ejecutará el método /nsertarAlumno: 


public void 
( 
using (bd_ 
( 
var ObjAl 


nsertarAlumno() 


CAPÍTULO 16: FORMULARIOS WEB 877 


otasAlumnosContexto bd = new bd_notasAlumnosContexto()) 


umno = new 


TryUpdateModel(objAl 


1f (Model 
( 


State.IsVa! 


// Guardar los ca 


bd.alu 


nos.Add(obj 


bd.SaveChanges():; 





etMsj.!l 





ext = "Alu 


alumno():; 
umno); 
id) 


bios 
Alumno); 


no añadido"; 


Para más detalles, repase el apartado Modelo de enlace de ASP.NET del capi- 


tulo ASP. NET. 


Ahora bien, en este caso, en el que estamos insertando un nuevo alumno 
(idem para una asignatura) no sería necesario utilizar un formulario web indepen- 
diente, sino que podríamos hacer la inserción sobre el propio ListView del formu- 
lario ActualizarEliminar. Para ello, hay que editar su plantilla InsertItemTem- 
plate para definir una interfaz de usuario personalizada para el elemento de 
inserción de ListView; en este caso, tendrá dos botones, Insertar y Borrar, y dos 
cajas de texto enlazadas con las propiedades id_alumno y nombre de un objeto 


alumno: 


<InsertItemlemplate> 
<tr style=""> 


<td> 


<asp:Button ID="InsertButton" runat="server" 


CommandName="Insert" 


Text="Insertar" /> 


<asp:Button ID="CancelButton" runat="server" 


</td> 
<td> 


<asp:TextBox 


</td> 
<td> 


<asp:TextBox 


</td> 
</tr> 


CommandName="Cancel" 





</InsertItemlemplate> 


D="id_alumnoTextBox" 
Text="<%j/ Bind("id_alumno") %>” /> 


D="nombreTextBox" 
Text="<%1 Bind("nombre") %>” /> 





Text="Borrar" /> 


runat="server" 


runat="server" 
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A continuación hay que especificar dónde se presenta esta interfaz de usuario. 
Esto se hace por medio de la propiedad InsertItemPosition (en ningún sitio, al 
principio o al final): 


<asp:ListView ID="ListView2" runat="server" 
ItemType="alumno" 
DataKeyNames="id_alumno" 
SelectMethod="0btenerAlumnos" 
UpdateMethod="ModificarAlumno" 
DeleteMethod="BorrarAlumno" 
InsertltemPosition="Lastltem" 
InsertMethod="InsertarAlumno" > 





Y finalmente, hay que establecer el nombre de método que hay que llamar pa- 
ra insertar datos, en nuestro caso InsertarAlumno: 


public void InsertarAlumno() 
( 
using (bd_notasAlumnosContexto bd = new bd_notasAlumnosContexto()) 
( 
var objAlumno = new alumno(); 
TryUpdateModel(objAlumno); 
if (ModelState.IsValid) 
( 
// Guardar los cambios 
bd.alumnos.Add(objAlumno); 
bd.SaveChanges(); 
) 





Obsérvese que este método es el mismo que el que realizamos anteriormente 
en el formulario AgregarAlumno. 


Llegados a este punto, probablemente habrá llegado a la conclusión de que 
utilizando el modelo de enlace de ASP.NET, interaccionar con la capa de acceso a 
datos es más directo que con los objetos de acceso a datos (tales como SqlData- 
Source y EntityDataSource). 


Capa de la lógica de negocio 


El modelo de enlace de ASP.NET permite poner el código que necesitamos escri- 
bir para acceder a la capa de datos (por ejemplo, los métodos para seleccionar, ac- 
tualizar, borrar o insertar registros), ya sea en el fichero de código subyacente de 
cada página web (es el método que hemos seguido en la aplicación anterior) o en 
una clase de lógica de negocio independiente. 
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Utilizar los ficheros de código subyacente de cada página web puede ser váli- 
do para sitios web pequeños, pero en sitios grandes puede conducir a la repetición 
de código. Sirvan como ejemplo los métodos ObtenerAlumnos u ObtenerAsigna- 
turas de la aplicación anterior, los hemos tenido que repetir en más de una página. 
Repetir código implica un coste de mantenimiento mayor, al mismo tiempo que 
un código disperso en páginas dificulta la realización de pruebas. 


Entonces, ¿cómo podemos centralizar el código de acceso a la capa de datos? 
Pues creando una capa de lógica de negocio que contenga todo ese código, y per- 
mitiendo después que pueda ser utilizado por cada una de las páginas del sitio. 


Como ejemplo, partiendo de la aplicación anterior vamos a estudiar cómo 
crear esta capa de lógica de negocio. Empecemos por añadir a nuestro proyecto 
una nueva carpeta BLL; en nuestro caso, por tratarse de un sitio web, vamos a 
crear esta carpeta dentro de App_Code ya que el código que guarda esta carpeta 
puede ser accedido por cualquier otro código del sitio web. A continuación crea- 
mos en ella una clase que vamos a denominar GestionAlumsAsigs. 














Explorador de soluciones x 
a ©- a| 4 
Buscar en el Explorador de soluciones (Ctrl +) P~ 





E] Solución 'ModeloDeEnlaceASPNET' (1 proyecto) ^ 
4 8 http://localhost/ModeloDeEnlaceASPNET/ 
4 il App_Code 
4 5 BLL 
DB Model.Context.tt 
c= Model.Designer.cs 
D ¿3 Model.edmx 
b B Model.tt 
E Bin 
ma Scripts 
él ActualizarEliminar.aspx 


(AA e i 


A AgregarAlumno.aspx ~ 


Explorador de sol... Vista de clases Explorador de ser... 


La clase GestionAlumsAsigs contendrá, en principio, todos los métodos de ac- 
ceso a datos que anteriormente añadimos en los ficheros de código subyacente de 
las páginas web. Estos métodos serán los mismos, pero con pequeños cambios. El 
cambio más importante es que ya no estaremos ejecutando el código desde un ob- 
jeto Page que es quien aporta el método TryUpdateModel y la propiedad Mo- 
delState que hemos venido utilizando en ese código de acceso a datos. Entonces, 
¿cómo va a acceder nuestra clase GestionAlumsAsigs a esa funcionalidad? Muy 
sencillo: añadiendo en cada método que lo necesite un parámetro de tipo Model- 
MethodContext del espacio de nombres System.Web.UI.WebControls. Por 
ejemplo: 
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public void ModificarAlumno(int ¡id_alumno, ModelMethodContext mmc) 
( 
using (bd_notasAlumnosContexto bd = new bd_notasAlumnosContexto()) 


( 
// Cargar el elemento 
alumno objAlum = bd.alumnos.Find(id_alumno); 
if (objAlum == null) return; 
(objAlum); 

if A .IsValid) 
( 

// Guardar los cambios 

bd.SaveChanges():; 


1 
J 


La clase ModelMethodContext se utiliza para invocar al método Update- 
Model o TryUpdateModel y a la propiedad Page.ModelState de Page cuando 
este objeto no es accesible directamente. 


El método anterior estaba escrito en el fichero de código subyacente de la pá- 
gina web ActualizarEliminar y su función es permitir modificar los elementos del 
control ListView2. Pero añadir ese parámetro no es suficiente, también hay que in- 
formar al control de servidor ListView2 de a quién pertenecen ahora los métodos 
de acceso a datos a los que hacen referencia sus propiedades SelectMethod, Up- 
dateMethod, DeleteMethod e InsertMethod. 


Los controles de servidor para acceso a datos, además de las propiedades 
mencionadas, proporcionan un evento CallingDataMethods (OnCallingData- 
Methods en ASP.NET), heredado de DataBoundControl del espacio de nombres 
System. Web.UI.WebControls, que se genera cuando se llama a alguno de los 
métodos de datos referenciados por esas propiedades. Pues bien, el controlador de 
este evento es el lugar idóneo para informar al control de servidor de a qué objeto 
pertenecen sus métodos de acceso a datos. 


Según lo expuesto, añadimos a ListView2 el controlador de ese evento: 

<asp:ListView ID="ListView2" runat="server" 

ItemType="alumno" 

DataKeyNames="id_alumno" 
SelectMethod="0btenerAlumnos" 
UpdateMethod="ModificarAlumno" 
DeleteMethod="BorrarAlumno" 
InsertItemPosition="Lastltem" 
InsertMethod="InsertarAlumno" 
OnCallingDataMethods="ListView_CallingDataMethods" > 
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A continuación, nos dirigimos al fichero de código subyacente de la página 
web actual y completamos este controlador así: 


protected void ListView_CallingDataMethods(object sender, 
CallingDataMethodsEventArgs e) 
( 
e.DataMethodsObject = new GestionAlumsAsigs(); 
) 


Este método indica a ListView2 que el objeto que contiene los métodos de ac- 
ceso a datos (valor asignado a la propiedad DataMethodsObject) es el objeto de 
la clase GestionAlumsAsigs que acabamos de crear. Esto implica que todos los 
métodos de acceso a datos de este control, independientemente de que hagan uso 
o no de TryUpdateModel y de ModelState, tienen que ser definidos en esta clase. 


Sólo queda hacer lo mismo para el resto de controles de servidor de acceso a 
datos utilizados en las páginas de nuestro sitio web. Cuando haya finalizado, ob- 
servará que todo funciona como esperábamos (puede obtener el código en la car- 
peta Cap161ModeloDeEnlaceASPNET?2 del CD correspondiente al libro). 


Paginación, ordenación y filtrado 


Dependiendo del control de servidor de acceso a datos que utilicemos, las opera- 
ciones de paginación y ordenación las tendremos resueltas estableciendo la pro- 
piedad del control que habilita dicha operación, no sucediendo lo mismo con el 
filtrado que tendremos que implementarlo, generalmente, en base a los atributos 
proveedores de valores si es que estamos utilizando el modelo de enlace de datos 
de ASP.NET. 


Por ejemplo, la propiedad AllowSorting del control GridView cuando vale 
true permite al usuario ordenar los elementos de dicho control respecto de una co- 
lumna concreta, al hacer clic en la cabecera de la columna. Así mismo, la propie- 
dad AllowPaging de este control cuando vale true permite repartir 
automáticamente todos los registros entre varias páginas. En cambio, si queremos 
filtrar los registros que cumplan alguna condición, tendremos que escribir el códi- 
go que permita realizar tal selección. 


Vamos a ver cómo implementamos estas operaciones con un ejemplo basado 
en la base de datos bd_notasAlumnos que hemos venido utilizando a lo largo de 
este capítulo. Para ello, vamos a crear un nuevo sitio web, denominado FiltrarDa- 
tos, que muestra una página análoga a la de la figura siguiente, en la cual podemos 
observar un control GridView, gvAlumnos, que muestra la lista de alumnos obte- 
nida de la base de datos, otro GridView, evAsignaturas, que muestra la lista de 
asignaturas de las que está matriculado el alumno seleccionado, o bien, en función 
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del botón de opción seleccionado, solo las asignaturas aprobadas o suspensas, y 
un FormView con una caja de texto que muestra la nota de la asignatura y 
alumno seleccionados. 





r 





<] 5 ¡8 http://localhost/FiltrarDatos/Default.aspx 











Lista de alumnos: 


ID Nombre 
Seleccionar 1234560 Alberto García Sánchez 
Seleccionar 1234561 Isabella Dulce Bella 
Seleccionar 1234562 Luis Gonzalez Arrutia 
Seleccionar 1234563 Pedro Garcia Rojas 
Seleccionar 1234567 Leticia Aguirre Soriano 
Seleccionar 1234568 Antonio Baena Sarasola 


Seleccionar 1234569 Rosa Estrada Rios 


Todas O Aprobadas O Suspensas 


Lista de asignaturas: 


ID Nombre 
Seleccionar 20591 LAB. DE PROGRAMACION AVANZADA 
Seleccionar 30215 LAB. DE FUNDAMENTOS DE PROGRAMACION 
Seleccionar 32346 PROGRAMACION AVANZADA (OPTATIVA) 


Seleccionar 33693 PROGRAMACION VISUAL 


Nota del alumno y asignatura seleccionados: 
7,5 

















Suponiendo que ya ha realizado este diseño y que ha añadido al proyecto un 


elemento de 


tipo ADO.NET Entity Data Model para generar el contexto de objetos 


bd _notasAlumnosContexto que gestiona las tablas alumnos, alums_asigs y asig- 
naturas de la base de datos bd_notasAlumnos, vamos a configurar el GridView 
gvÁAlumnos para que pueda obtener del contexto de objetos la lista de alumnos y 
sus identificadores. Para ello, estando en la ventana de diseño, no tiene nada más 
que seleccionar el control gvAlumnos y establecer su propiedad SelectMethod 
con el nombre del método que se ejecutará para obtener esa lista: 


<asp:GridView ID="gvAlumnos" runat="server" 
AutoGenerateColumns="False" AutoGenerateSelectButton="True" 
DataKeyNames="id_alumno" 
SelectMethod="0btenerAlumnos" > 
<Columns> 
<asp:BoundField DataField="1id_alumno" HeaderText="ID" 


Read0nly="True" 


</Columns> 


</asp:GridView> 
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Según lo expuesto, el método ObtenerAlumnos lo escribiremos en el fichero 
de código subyacente de esta página así: 


public IQueryable<alumno> ObtenerAlumnos() 

( 
bd_notasAlumnosContexto bd = new bd_notasAlumnosContexto():; 
var consulta = bd.alumnos; 


return consulta; 


1 
$ 


Si ahora ejecuta la aplicación, observará que la tabla se llena con la lista de 
alumnos y sus identificadores. 


Para permitir la ordenación de las filas del GridView por cualquier columna, 
asigne a su propiedad AllowSorting el valor true. 


Para distribuir en páginas el contenido del GridView, asigne a su propiedad 
AllowPaging el valor true. Cada página tendrá PageSize registros (el valor pre- 
determinado es 10), en nuestro ejemplo, 5. Al habilitar la paginación, se añade 
una fila adicional con los controles que permiten al usuario navegar a otras pági- 
nas. Esta fila se puede configurar a través de las propiedades PagerSettings, Posi- 
tion y Mode. 


<asp:GridView ID="gvAlumnos" runat="server" 
AutoGenerateColumns="False" 
AutoGenerateSelectButton="True" 
DataKeyNames="id_alumno" 
SelectMethod="0btenerAlumnos" 
AllowSorting="True" 
AllowPaging="True" PageSize="5" > 


Ejecute ahora la aplicación y pruebe cómo funciona la ordenación y la pagi- 
nación. La paginación mejora la eficiencia de la aplicación, porque en lugar de re- 
cuperar la totalidad de los registros, el GridView modifica la consulta para 
recuperar solo los registros de la página actual. 


En ocasiones, puede ser que no desee obtener todos los registros de una de- 
terminada tabla, sino solo aquellos que cumplen una determinada condición; por 
ejemplo, todos aquellos alumnos que tienen un apellido “García”. Para un ejemplo 
como este tendríamos que modificar el método ObtenerAlumnos así: 


public IQueryable<alumno> ObtenerAlumnos([QueryString] string clave) 
( 


bd_notasAlumnosContexto bd = new bd_notasAlumnosContexto():; 
IQueryable<alumno> consulta = bd.alumnos; 
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if (!String.IsNull0rWhiteSpace(clave)) 
{ 

consulta = consulta.Where(e => e.nombre.Contains(clave)); 
} 


return consulta; 


Ahora podemos filtrar los registros a presentar por el GridView especificando 
el valor para el parámetro clave en la cadena de consulta (en la URL) según mues- 
tra la figura siguiente: 














r _- = YO EVA 
a e http://localhost/FiltrarDatos/Default.aspx AEREA 
Lista de alumnos: lo 
1D Nombre 


Seleccionar 1234560 Alberto Garcia Sanchez 
Seleccionar 1234563 Pedro Garcia Rojas 








Evidentemente, dicho valor podría proceder de un control, por ejemplo, de un 
TextBox: 


public TQueryable<alumno> ObtenerAlumnos([Control("TextBox1")] string clave) 


En este caso, después de introducir el valor en la caja de texto, habría que re- 
enviar la página al servidor. Veremos un poco más adelante un ejemplo que utili- 
ce este atributo proveedor de valores. 


Continuando con la aplicación, cuando el usuario seleccione un alumno en la 
rejilla evA/umnos, la otra rejilla, gvAsignaturas, tendrá que mostrar las asignaturas 
correspondientes a este alumno: todas, las suspensas o las aprobadas, en función 
del botón de opción que esté seleccionado. 


Para poder seleccionar un registro de gvAlumnos vamos a agregar a este con- 
trol una columna (objeto CommandField) con un botón Seleccionar por cada fila 
que muestra el GridView. Para ello, establezca su propiedad AutoGenerate- 
SelectButton a true. Ahora, cuando el usuario haga clic en el botón Seleccionar 
de una fila, se selecciona esa fila en el control, lo que establece su propiedad Se- 
lectedIndex en el índice de la fila, y se reenvía la página al servidor. La fila se- 
leccionada está representada por un objeto GridViewRow y se puede recuperar 
por medio de la propiedad SelectedRow. El valor de clave principal para el regis- 
tro seleccionado se obtiene por medio de la propiedad SelectedValue. Esta pro- 
piedad contiene los valores de los campos de clave especificados en la propiedad 
DataKeyNames del GridView. 
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Según lo expuesto, vamos a configurar el GridView gvAsignaturas para que 
pueda obtener del contexto de objetos la lista de asignaturas y sus identificadores. 
Para ello, estando en la ventana de diseño, no tiene nada más que seleccionar este 
control y establecer su propiedad SelectMethod con el nombre del método que se 
ejecutará para obtener esa lista: 


<asp:GridView ID="gvAsignaturas” runat="server" 
AutoGeneratelolumns="False" 
DataKeyNames="1id_asignatura" 
SelectMethod="0btenerAsignaturasAlum" 
AutoGenerateSelectButton="True"> 
<Columns> 
<asp:BoundField DataField="id_asignatura" HeaderText="ID" 


</Columns> 
</asp:GridView> 


De acuerdo con lo explicado hasta ahora, el método ObtenerAsignaturasAlum 
lo escribiremos en el fichero de código subyacente de esta página así: 


public IQueryable<asignatura> ObtenerAsignaturasAlum( 
[Control("gvAlumnos", "SelectedValue")] int? ¡idAlumno) 
( 
if (lidAlumo.HasValue) return null; 
bd_notasAlumnosContexto bd = new bd_notasAlumnosContexto(); 
var consulta = 
from al_as in bd.alums_asigs 
where al_as.id_alumno == idAlumno 
select al_as; 
if (rbAprobadas.Checked) consulta = consulta.Whereíla => a.nota >= 5); 
if (rbSuspensas.Checked) consulta = consulta.Wherela => a.nota < 5); 
return consulta.Selectía => a.asignatura); 











S1 ahora ejecuta la aplicación y selecciona un alumno, observará que la tabla 
de asignaturas muestra la lista de asignaturas (todas, aprobadas o suspensas, en 
función del botón de opción seleccionado) correspondientes a dicho alumno. 


Finalmente, para conocer la nota de una asignatura, el usuario seleccionará 
esa asignatura, mostrándose la nota en la caja de texto c£Nota de un FormView. 
Dicha caja de texto tendrá enlazada su propiedad Text con el campo nota del ob- 
jeto alum_asig correspondiente, obtenido a través del método FormViewl_Obte- 
nerNota especificado por la propiedad SelectMethod del FormView. 


<asp:FormView ID="FormView1" runat="server" 
ItemType="alum_asig" 
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DataKeyNames="id_alumno, id_asignatura" 
SelectMethod="0btenerNota" > 
<ItemTemplate> 
<asp:TextBox ID="TextBox1" runat="server" 
Read0nly="True" /> 
</ItemTemplate> 
</asp:FormView> 


El método ObtenerNota lo escribiremos en el fichero de código subyacente de 
esta página así: 


public alum_asig ObtenerNota( 
[Control("gvAsignaturas", "SelectedValue")] int? idAsignatura, 
[Control("gvAlumnos”, "SelectedValue")] int? idAlumno) 


if (lidAsignatura.HasValue || !idAlumno.HasValue) return null; 
bd_notasAlumnosContexto bd = new bd_notasAlumnosContexto():; 
var consulta = 
from al_as in bd.alums_asigs 
where al_as.id_alumno == idAlumno 42 
al_as.id_asignatura == idAsignatura 
select al_as; 
1f (consulta.Count() == 0) return null; 
return consulta.First(); 











Este método obtiene el objeto alum_asig identificado por las claves idAlumno 
e idAsignatura que está vinculado con el FormView para mostrar el campo nota. 


Queda una cosa por hacer, que es actualizar la rejilla gvAsignaturas cada vez 
que seleccionemos un botón de opción (Todas, Aprobadas o Suspensas). Para 
ello, añada el controlador del evento CheckedChanged de estos controles (el 
mismo controlador para todos) y complételo como se indica a continuación: 


protected void rb_CheckedChanged(object sender, EventArgs e) 
( 
gvAsignaturas.DataBind(); 


1 
j 


La aplicación está finalizada. Se habrá dado cuenta de que es una aplicación 
típica maestro-detalle, técnica que ya fue expuesta en capítulos anteriores. 
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EJERCICIOS PROPUESTOS 


1. Realice de nuevo la aplicación Sqg/DataSource (control SqlDataSource) para que 
prescinda de los métodos Page Load y btConsultarNota Click de la clase 
_ Default, así como de las etiquetas e£Nombre, etNota y etError, y añada un nuevo 
control de tipo DetailsView en su lugar, por ejemplo, que muestre los datos nom- 
bre y nota obtenidos de otro objeto SqlDataSource que realice la consulta que 
hacía el método btConsultarNota_Click. 


2. Realice de nuevo la aplicación EntityDataSource (control EntityDataSource) 
para que prescinda de los métodos Page_Load y biConsultarNota_Click de la cla- 
se FormWebNotas, así como de las etiquetas e£Nombre, etNota y etError, y añada 
un nuevo control de tipo DetailsView en su lugar, por ejemplo, que muestre los 
datos nombre y nota obtenidos de otro objeto EntityDataSource que realice la 
consulta que hacía el método btConsultarNota_ Click. Finalmente, ¿cómo realiza- 
ría esta última consulta interceptando el evento Selecting del control? 


3. Realice otra versión de la aplicación ModeloDeEnlace para que prescinda del 
EDM y utilice CodeFirst. Por lo tanto, se puede prescindir de los controles de va- 
lidación y utilizar atributos de anotación en su lugar. 
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SERVICIOS WEB 


Los servicios web son componentes que se ejecutan en el servidor y suelen im- 
plementar la capa de reglas de negocio. Al igual que los componentes tradiciona- 
les, los servicios web muestran una interfaz a través de la cual otras aplicaciones 
acceden a los servicios ofrecidos. 


Lo importante de esta tecnología es que un servicio web está disponible a tra- 
vés de protocolos web, lo que lo hace compatible con programas que se ejecutan 
en diferentes lenguajes, en distintos equipos e, incluso, en diferentes sistemas ope- 
rativos. Esto es, se trata de un componente al que se puede acceder desde cual- 
quier aplicación que sea capaz de generar mensajes e interpretar mensajes escritos 
en SOAP, un protocolo simple y ligero basado en XML, que viaja sobre protoco- 


los de transporte estándar como HTTP, que facilita una comunicación basada en 
mensajes. 


Equipo cliente Servidor de aplicaciones 


eo 
Soo Ni 
















































































Petición E 
[E SOAP sobre HTTP E 
Ii 
cliente web 
L] Respuesta d 
LN i Y 














De forma genérica podemos decir que un servicio web es una aplicación que 
se instala en un servidor desde el cual prestará sus servicios a las aplicaciones 
cliente que lo soliciten. Desde esta definición: 


e Un proveedor de servicios crea un servicio web, lo instala en un servidor, lo de- 
fine mediante un documento WSDL y lo registra en el directorio de servicios. 
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Un usuario realiza una aplicación cliente que necesita de un determinado ser- 
vicio, encuentra ese servicio web buscando en el directorio de servicios, enla- 
za su aplicación con dicho servicio y la aplicación interactúa con el servicio 
utilizando mensajes SOAP e intercambiando datos en XML. 


Integrar un servicio web en una aplicación 


La clave para que los servicios web funcionen por toda la red y su heterogénea in- 
fraestructura fue ponerse de acuerdo en un simple formato de descripción de da- 
tos: XML. ¿Por qué requieren XML los servicios web? Por tres razones: 


1. 


Se necesita encontrar el servicio web. Los directorios de servicios web pro- 
porcionan una ubicación central para localizar en Internet servicios web XML 
proporcionados por otras organizaciones. Estos directorios, como UDDI 
(Universal Description, Discovery and Integration — descripción, descubri- 
miento e integración), cumplen esta función. 


Para invocar a un servicio web necesitamos conocer cómo acceder al mismo, 
qué operaciones soporta, qué parámetros espera el servicio y qué retorna. 
WSDL (Web Services Description Language — lenguaje de descripción de 
servicios web) proporciona toda esta información en un documento XML que 
puede ser leído o procesado por el cliente. 


Finalmente, para que las aplicaciones puedan comunicarse entre sí, necesitan 
hablar el mismo lenguaje. El protocolo SOAP define el formato de los mensa- 
jes XML que son utilizados en esta comunicación (se utiliza sobre HTTP). 


Encontrar un servicio 







http://www.uddi.org 


Documento WSDL | 


¿Cómo interactuar? (WSDL) 








UDDI 






http://su-servicio.com/sv?wsdl 


Descripción del servicio 


Interactuando (SOAP) 


http://su-servicio.com/sv i 
== a A 


Respuesta XML/SOAP 


Cliente 
Servicio 
web 





La figura anterior muestra cómo un cliente interactúa con un servicio web. 


Primero, el cliente intenta localizar el servicio web por medio de una URL a un 
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documento de descubrimiento (http://.../servicio.svc?disco) y se obtiene la URL 
del documento de descripción del servicio (Attp://.../servicio.svc?wsdl) que permi- 
te descargar este documento, el cual es procesado por el cliente para construir el 
proxy que le permita interactuar con el servicio web. 


Resumiendo, del mismo modo que TCP/IP proporcionó la conectividad uni- 
versal para Internet y HTML proporcionó un lenguaje normalizado para mostrar 
información en diversas plataformas, XML (lenguaje de marcado extensible) es 
un lenguaje normalizado para describir los datos a intercambiar, mientras que 
SOAP es un protocolo para intercambio de mensajes codificados en XML utiliza- 
do para la comunicación entre los servicios web y sus clientes. 


SERVICIOS WCF 


¿Qué es WCF? WCF, acrónimo de Windows Communication Foundation, es un 
marco de trabajo unificado para hacer fácil la comunicación entre aplicaciones di- 
versas en cualquier plataforma (.NET, J2EE, etc.) combinando en una sola tecno- 
logía lo que en versiones anteriores de Visual Studio existía en varias tecnologías: 
servicios web ASMX, .NET Remoting (mover datos entre un cliente y un servi- 
dor), Enterprise Services (realizar comunicaciones por transacción) y Message 
Queue Server (comunicación mediante mensajes). O sea, que WCF no es solo una 
nueva forma de escribir servicios web, sino también un marco de trabajo que apli- 
ca un enfoque orientado al servicio a otros métodos de conectividad. De forma re- 
sumida, diríamos que los aspectos más importantes de WCF son: 


e Unificación de las tecnologías de comunicación .NET Framework existentes. 

e Compatibilidad para interoperabilidad entre proveedores, incluyendo confia- 
bilidad, seguridad y transacciones. 

e Orientación explícita al servicio. 


Un servicio no es más que una aplicación que intercambia mensajes con otras 
aplicaciones, por lo tanto, es una unidad ideal para crear soluciones distribuidas. 
Piense en una solución distribuida usando programación orientada a objetos; co- 
mo ya conocemos, esto nos obligaría a trabajar con tipos comunes perdiendo en- 
tonces la interoperabilidad porque no podríamos establecer una comunicación con 
otras plataformas diferentes que no reconocieran estos tipos de objetos. En cam- 
bio, en una solución orientada a servicios, como se intercambian mensajes, los 
dos extremos de la comunicación pueden perfectamente pertenecer a plataformas 
diferentes; es suficiente con que ambos extremos utilicen la misma política de 
comunicación. 


Los servicios son autónomos y comparten esquemas (datos) y contratos (fun- 
cionalidad), no clases ni tipos en general y al intercambiar mensajes no tienen que 
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asumir nada acerca de “qué es lo que hay al otro lado del extremo”. En la vida or- 
dinaria tenemos multitud de ejemplos; quién como cliente no ha llamado al “ser- 
vicio de soporte técnico X” y, como resulta evidente, no hay una relación entre 
cliente y servidor, simplemente hay un intercambio de mensajes para comunicar 
la incidencia para la que deseamos nos den una solución. Evidentemente, de este 
ejemplo podemos deducir también que el servicio es autónomo; la infraestructura 
del servicio podrá cambiar, pero eso no tiene por qué afectar al cliente. 


En resumen, los clientes consumen servicios y los servicios ofrecen solucio- 
nes a los clientes intercambiando mensajes, con lo que un servicio puede, a su 
vez, ser cliente de otro servicio. En WCF los mensajes tienen una cabecera y un 
cuerpo y son definidos en XML según el protocolo SOAP. A continuación se 
muestra cómo es el esqueleto de un mensaje SOAP: 


<?xml] version="1.0"?> 
<soap:Envelope xmlns:soap="http://www.w3.org/..." 
soap:encodingStyle="http://www.w3.org/..."> 


<soap:Header> 
información específica de la aplicación, como la autenticación 
</soap:Header> 


<soap:Body> 
mensaje destinado al punto final de la comunicación 
<soap:Fault> 
para indicar mensajes de error 
</soap:Fault> 
</soap:Body> 


</soap:Envelope> 


MODELO DE PROGRAMACIÓN DE WCF 


WCF simplifica el desarrollo de aplicaciones distribuidas reuniendo la funcionali- 
dad proporcionada por las tecnologías indicadas en el apartado anterior bajo un 
modelo de programación unificado fundamentado en la comunicación basada en 
mensajes entre dos entidades: un cliente WCF y un servicio WCF. El cliente es la 
aplicación que inicia la comunicación y el servicio es la aplicación que espera a 
que el cliente se comunique con él y responder así a su petición. Incluso, una úni- 
ca aplicación puede actuar como cliente y como servicio. Este modelo de progra- 
mación orientado a servicios está definido por las clases agrupadas bajo el espacio 
de nombres System.ServiceModel. 
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Implementar un servicio WCF 


Un servicio es una aplicación que expone uno o más extremos, donde cada uno de 
ellos expone una o más operaciones del servicio. 


Extremo: 
dirección, 
enlace y 
contrato 





WCF 


El extremo o punto final proporciona la única manera de comunicación con el 
servicio. Un extremo está compuesto de una dirección, un enlace y un contrato. 
La dirección define la ubicación del servicio; esta podría ser una dirección URL, 
por ejemplo ht1p.//servidor/miservicio, una dirección FTP o una ruta de acceso lo- 
cal o de red. Un enlace define la manera de establecer la comunicación con el ser- 
vicio, por ejemplo BasicHttpBinding, WSHttpBinding, WSDualHttpBinding o 
NetTcpBinding; los enlaces de WCF permiten especificar con facilidad un proto- 
colo como HTTP o FTP, un mecanismo de seguridad como autenticación de 
Windows o nombres de usuario y contraseñas, y muchas otras características. Y 
un contrato incluye las operaciones expuestas por la clase de servicio WCF. 


Un servicio WCF puede exponer varios extremos, según indica la figura ante- 
rior, lo que permitirá a distintos clientes comunicarse con él de formas diferentes. 
Por ejemplo, un servicio de consulta de actas de notas en la universidad podría 
proporcionar un extremo para profesores y otro para los alumnos, cada uno me- 
diante una dirección, enlace y/o contrato diferentes. 


A continuación describiremos con un ejemplo cada una de las tareas necesa- 
rias para crear un servicio WCF para ASP.NET y un cliente que pueda llamar al 
servicio. Un servicio WCF puede construirse como una aplicación de servicios 
WCF hospedada en IIS o como una biblioteca de servicios WCF e iniciarlo, al 
igual que otros servicios, en nuestra máquina, de forma manual o automática y 
como servicio local o de red. 


Un servicio WCF solo utiliza al servidor de aplicaciones, por ejemplo a IIS, 
como intermediario, pero se ejecuta siempre en el marco de ejecución de WCF, lo 
que le permite mantener su estado. 
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Definir un contrato 


Según lo expuesto anteriormente, la primera tarea para crear un servicio es definir 
el contrato. El contrato se corresponde con una interfaz, marcada con el atributo 
ServiceContract, que especifica las operaciones que ofrece el servicio. Cada una 
de estas operaciones será proporcionada por un método de la clase del servicio 
web marcado con el atributo OperationContract. Los métodos que no estén mar- 
cados con este atributo no serán expuestos a los clientes. Según esto, un contrato 
tendrá el aspecto siguiente: 


[ServiceContract] 

public interface IConvertirGrados 
( 
// Operaciones ofrecidas por el servicio 
[OperationContract] 

double ConvCentAFahrídouble gCent); 








[OperationContract] 
double ConvFahrACent(double gFahr); 
) 


El atributo ServiceContract hace referencia a la clase ServiceContractAt- 
tribute para indicar que la interfaz /ConvertirGrados define un contrato de servi- 
cio en una aplicación WCF y OperationContract hace referencia a la clase 
OperationContractAttribute para indicar que un método, como ConvCentAFahr 
o ConvFahrACent, define una operación que forma parte de un contrato. Utilizan- 
do esta funcionalidad, el entorno de ejecución de WCF traducirá el contrato de 
servicio en la estructura correspondiente en el CLR y viceversa, de forma que el 
desarrollador pueda abstraerse de la interoperabilidad y centrarse en la solución 
del problema. 


Pasemos a la parte práctica. Como ejemplo vamos a crear un servicio WCF 
que muestre una interfaz para que una aplicación cliente ASP.NET pueda solicitar 
convertir un valor en grados Fahrenheit a su correspondiente valor en grados cen- 
tígrados y viceversa. Hospedaremos el servicio en IIS. Entonces, abra Visual Stu- 
dio como administrador y cree un nuevo sitio web. Elija la plantilla Servicio 
WCF, la ubicación HTTP, el lenguaje C# y denomínelo ServWebWCFConver- 
Temps. Después haga clic en Aceptar. 


r 


CAPÍTULO 17: SERVICIOS WEB 895 








Ubicación web: 








HTTP 


Nuevo sitio web Lo ju” 
b Reciente NET Framework 4.5 + Ordenar por: Predeterminado - iF [=] Buscar en la F ® ~ 
4 Instalado cs es 
SN Sitio web vacio de ASP.NET Visual C# Tipo: Visual C# 
a Plantillas cs Un sitio web para crear servicios WCF 
Visual Basic 51 Sitio de ASP.NET Web Forms Visual C# 
Visual C# ce 
Ejemplos [a] Sitio web ASP.NET (Razor v1) Visual C# 
cr 
b En línea a 


(0) Sitio web de ASP.NET (Razor... Visual C# 


ce 
6 Sitio web de entidades de dat... Visual C# 
e 


CE Servicio WCF 


”  ttp://localhost/ServWebWCFConverTemps > Examinar... | 


Visual C# 


e 
agf] Sitio web de informes ASP.NET Visual C# 





[aceptar | Cancelar | 














Observe el Explorador de soluciones. Vemos que se ha creado un nuevo pro- 
yecto http://localhost/ServWebWCFConverTemps que incluye el fichero Servi- 
ce.svc, que actúa como punto de entrada al servicio WFC, que está vinculado con 
el fichero App_CodelService.cs que contiene la clase que construye el servicio (la 
lógica de negocio), la cual implementa la interfaz IService.cs que se corresponde 
con el contrato que define las operaciones que ofrece el servicio WFC: 


Explorador de soluciones 





Ga o- I 


Buscar en el Explorador de soluciones (Ctrl+”) 








> 4/3 











AX 


p~- 


El Solución 'ServWebWCFConverTemps' (1 proyecto) 
4 © http: //localhost/ServWebWCFConverTemps/ 


4 sl App_Code 
e= IService.cs 
© Service.cs 

E App_Data 


Service.svc 


A Web.config 


Explorador de sol... Vista de clases Explorador de ser... 


Puede cambiar los nombres y adaptarlos al contexto de la aplicación. Por 
ejemplo, cambie el nombre del fichero /Service.cs por IServWebWCFConver- 
Temps.cs y el nombre de la interfaz /Service por IServWebWCFConverTemps. Es- 
te cambio exige hacer el mismo cambio en la clase que implementa esta interfaz. 


Cambie el nombre del fichero Service.cs por ServWebWCFConverTemps.cs y 
el nombre de la clase Service por ServWebWCFConverTemps. Este cambio exige 
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hacer el mismo cambio en los atributos de la cláusula ServiceHost del fichero aso- 
ciado .svc. 


Finalmente, cambie el nombre del fichero Service.sve por ServWebWCFCon- 
verTemps.svc. 


Genere el proyecto, muestre el fichero ServWebWCFConverTemps.svc y eje- 
cute (CtrI+F5) la aplicación. Se mostrará el cliente de prueba de WCF que permi- 
tirá probar cada una de las operaciones: 






































f El 
EN Cliente de prueba WCF =| 
Archivo Herramientas Ayuda 
| E-E Mis proyectos de servicios || GetData | 
E-:8) http:/Mocalhost/ServWebWCFConvel 
E-*Q IServWebWCFConverTemps (Bas| || Solicitud 
®© GetData() 
© GetDataUsingDataContract() Nombre Valor Tipo 
D Archivo de configuración velo 1123 parten desa 
Resuesta E] Iniciar un nuevo proxy [tnvocar 
Nombre Valor Tipo 
(retum) "You entered: 123" System.String 
Con formato | XML | 
La invocación del servicio se ha completado. 
y 

















También puede dirigirse al explorador de soluciones, hacer clic con el botón 
secundario del ratón sobre el nombre del fichero .svc y ejecutar Ver en Explora- 
dor... El explorador le mostrará una página en la que se puede ver el documento 
XML que describe el servicio en WSDL y la pauta a seguir para probar las opera- 
ciones del servicio; esto es, utilizando la herramienta svcutil.exe generaríamos el 
proxy (ServWebWCFConverTemps.cs) y el fichero de configuración (out- 
put.config > app.config) que incluiríamos en una aplicación de consola cliente del 
servicio desde la que podríamos llamar a las operaciones del servicio. 
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[E 
Æ http://localhost/Sen s/se P ~ R © || 8 Servicio de SevWebWC... 7 


Servicio de ServWebWCFConverTemps ÉS 


Creó un servicio, 








Para probarlo, deberá crear un cliente y usarlo para llamar al servicio. Para ello, puede usar la herramienta svcutil.exe en la 
línea de comandos con la siguiente sintaxis: 


sycutil.exe http: //localhost/ServWebWCFConverTemps/ServWebWCFConverTemps.svc?wsdl 





También puede tener acceso a la descripción del servicio como un solo archivo: 


http: //localhost/ServWebWCFConverTemps/ServWebWCFConverTemps.svc?singleWsdl 





Esto generará un archivo de configuración y un archivo de código que contiene la clase de cliente. Agregue los dos archivos 
a la aplicación cliente y use la clase de cliente generada para llamar al servicio. Por ejemplo: 


c# 
class Test 


{ 


static void Main () 
{ 


ServWebWCFConverTempsClient client = new ServWebWCFConverTempsClient (); 
// Use la variable 'client' para llamar a operaciones en el servicio. 


// Cierre siempre el cliente. 
client.Close(); 




















Si al ejecutar el servicio WCF obtiene el siguiente error: 
Error HTTP 404.3 - Not Found 


No puede obtener acceso a la página solicitada debido a la configuración de la 
extensión. Si la página es un script, agregue un controlador. Si se debe cargar el 
archivo, agregue una asignación MIME. 


ejecute la siguiente orden desde la consola de Windows: 


C:AWindowsIMicrosoft.NET1FrameworkAv3.01Windows Communication Foun- 
dation1ServiceModelReg.exe -i 


para registrar las ISAPI (interfaz de programación de aplicaciones para IIS) que 
controlan las respuestas para las solicitudes *.svc. 


A continuación, vamos a definir el contrato del servicio (ServiceContract), 
esto es, las operaciones que ofrece el servicio. En nuestro caso, en principio, ofre- 
ce dos: la conversión de grados centígrados a Fahrenheit y viceversa. Aplique el 
atributo OperationContract a cada método que desea exponer como parte del 
contrato WCF público. 


using System.ServiceModel'; 


[ServiceContract(Namespace="http://websol.aut.uah.es/ServiciosWeb/")] 
public interface IServWebWCFConverTemps 


( 
// Operaciones del servicio 
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[OperationContract] 
double ConvCentAFahr(double gCent); 


[OperationContract] 
double ConvFahrACentí(double gFahr); 


Observe la cláusula Namespace del atributo ServiceContract: especifica el es- 
pacio de nombres al que pertenecerá el servicio. Especificar el espacio de nom- 
bres explícitamente es un procedimiento recomendado porque distinguirá al 
servicio de otros con el mismo nombre, lo que podría ocurrir si utiliza, por omi- 
sión, el espacio de nombres predeterminado. 


Además del contrato del servicio, puede utilizar un contrato de datos (Data- 
Contract), como se ilustra en el ejemplo siguiente, para agregar tipos compuestos 
a las operaciones del servicio. Esto es, WCF utiliza un motor de forma predeter- 
minada para seriar y deseriar los datos de tipo de contrato de datos (convertirlos 
de y a XML). Todos los tipos primitivos de NET Framework, como enteros y ca- 
denas, así como ciertos tipos tratados como primitivos, como Date Time y XmlE- 
lement y otros tipos NET Framework son tipos de contrato de datos, por lo que se 
pueden seriar sin más. Esto es así porque la infraestructura WCF utiliza mensajes 
XML para el envío y recepción de datos entre el cliente y el servicio. 


Entonces, los nuevos tipos complejos que se creen deben tener un contrato de 
datos definido para que sean seriables por el motor DataContractsSerializer. Sólo 
pueden seriarse los atributos y propiedades de lectura y escritura públicos (no mé- 
todos) de estos tipos. La clase que defina ese contrato de datos irá marcada con el 
atributo DataContract, y las propiedades o campos, con el atributo DataMem- 
ber, para que el motor DataContractSerializer pueda proceder a la seriación y 
deseriación. 


Siguiendo con nuestro ejemplo, supongamos que queremos retornar un tipo 
más complejo que el simple valor en grados; por ejemplo, un objeto Detalles con 
tres atributos: información de si el valor convertido corresponde a grados centí- 
grados o Fahrenheit, un literal que incluya el valor y la leyenda “grados centígra- 
dos/Fahrenheit” y el valor en grados convertido. Según esto, el contrato de datos 
podría ser así: 


[DataContract(Namespace = "http://websol.aut.uah.es/ServiciosWeb/")] 
public class Detalles 
( 

private bool _sonCentigrados; 

private string _literal; 

private double _grados; 
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[DataMember] 
public bool SonCentigrados 
( 
get { return _sonCentigrados; } 
set { _sonCentigrados = value; ) 
) 


[DataMember] 
public string Literal 
( 





get { return _literal; ) 
set { _literal = value; } 


) 


[DataMember] 
public double Grados 
( 
get { return _grados; } 
set { _grados = value; ) 
) 
) 


Ahora, apoyándonos en esta clase, añadimos un nuevo método, a la interfaz 
IServWebWCFConverTemps, que nos permita dar estos detalles: 


[OperationContract] 
Detalles ResultadoDetallado(Detalles detalle); 


Después de definir el contrato de servicio y sus operaciones, y de definir el 
contrato de datos (este contrato es opcional), definimos la clase del servicio. En 
nuestro caso se trata de la clase ServWebWCFConverTemps que implementa la in- 
terfaz IServWebWCFConverTemps: 


using System.ServiceModel'; 


public class ServWebWCFConverTemps : IServWebWCFConverTemps 
( 
public double ConvCentAFahrídouble gCent) 
( 
double grados = Math.Round(9.0 / 5.0 * gCent + 32.0, 2); 
return grados; 


) 


public double ConvFahrACent(double grFahr) 

( 
double grados = Math.Round(((gFahr - 32.0) * 5.0) / 9.0, 2); 
return grados; 











) 
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public Detalles ResultadoDetallado(Detalles detalle) 
( 
if (detalle == null) 
( 
throw new ArgumentNullException("detalle"); 
) 
if (detalle.SonCentigrados) 
detalle.Literal = ConvCentAFahrí(detalle.Grados) 4 
" grados fahrenheit. 


else 
detalle.Literal = ConvFahrACentídetalle.Grados) + 
" grados centígrados."; 








return detalle; 


Sepa también que una clase de servicio WCF puede implementar varios con- 
tratos de servicio. 


El servicio WCF está finalizado. El siguiente paso es realizar una aplicación 
cliente del servicio que utilice el mismo. 


Configuración del servicio WCF 


Para que un cliente pueda consumir un servicio WCF, este debe ser configurado 
con los parámetros que indiquen dónde y cómo puede ser accedido. Cuando se 
trata de un servicio WCF alojado en IIS, su configuración se almacena en el fiche- 
ro Web.config de la aplicación, y si no está hospedado en IIS los elementos de 
configuración son prácticamente los mismos, pero se especifican en un fichero 
App.config. De forma resumida, este procedimiento consta de los siguientes pa- 
sos: crear una dirección base para el servicio, crear una nueva instancia de Servi- 
ceHost para hospedar el servicio que especifique el contrato de servicio y la 
dirección base, agregar un extremo que exponga el servicio y habilitar el inter- 
cambio de metadatos. 


La dirección base de un servicio hospedado en IIS es la dirección de su fiche- 
ro .svc (por ejemplo: http://servidor/serv01 WCF/miservicio) y el atributo Service 
de la cláusula ServiceHost de este fichero especifica el contrato de servicio. 


Para agregar un extremo (endpoint) que exponga el servicio hay que especifi- 
car el contrato que el extremo está exponiendo (contract), un enlace (binding) y la 
dirección del extremo (address). La dirección del extremo es una dirección relati- 
va; si se deja vacía, se supone la misma dirección que la base. En IIS, las direc- 
ciones de extremo siempre se consideran relativas a la dirección del fichero .svc. 
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Los enlaces son objetos que se utilizan para especificar los datos de la comu- 
nicación requeridos para conectar al extremo de un servicio WCF. Por ejemplo, 
wsHttpBinding utiliza el transporte HTTP, HTTPS y proporciona seguridad para 
mensajes, transacciones, mensajería confiable, etc., y basicHttpBinding está más 
bien pensado para guardar compatibilidad con lo anterior (estilo ASMX, SOAP 
1.1, etc.). 


Para habilitar el intercambio de metadatos hay que agregar al fichero de con- 
figuración la sección serviceBehaviors (equivale a crear un objeto ServiceMetada- 
taBehavior, establecer su propiedad HttpGetEnabled en true y agregar este 
comportamiento al servicio). 


A partir de NET Framework 4.5 si no se agrega ningún extremo en una sec- 
ción <service> y el servicio no define ningún extremo mediante programación, 
entonces se agrega automáticamente al servicio un conjunto de extremos prede- 
terminados. Por lo tanto, si no es necesario especificar ningún extremo o compor- 
tamientos del servicio, ni realizar ningún cambio de configuración de enlaces, no 
es necesario especificar ningún archivo de configuración de servicio. 


Como ejemplo, compare lo expuesto con la información de configuración de 
nuestro servicio WCF: 


<system.serviceModel> 
<behaviors> 
<serviceBehaviors> 
<behavior> 
<!-- Para evitar revelar información de los metadatos, 
establezca el valor siguiente en false antes de la 
implementación --> 
<serviceMetadata httpGetEnabled="true" 
httpsGetEnabled="true"/> 
<serviceDebug includeExceptionDetailInFaults="false"/> 
</behavior> 
</serviceBehaviors» 
</behaviors> 
<protocolMapping> 
<add binding="basicHttpsBinding" scheme="https" /> 
</protocolMapping> 
<serviceHostingEnvironment aspNetCompatibilityEnabled="true" 
multipleSiteBindingsEnabled="true" /> 





</system.serviceModel> 


La sección <protocolMappings> contiene una lista de esquemas de protoco- 
los de transporte asignada a los tipos de enlaces. 
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Implementar un cliente WCF 


Un cliente WCF está compuesto de un proxy que habilita a una aplicación para 
poder establecer comunicación con un servicio WCF y un extremo que coincide 
con un extremo definido para el servicio. Para los servicios que exponen varios 
extremos, el cliente puede seleccionar el que mejor se ajuste a sus necesidades; 


por ejemplo, uno que permita establecer una comunicación a través de HTTP y 
sin autenticación. 


SOAP 





WCF WCF 


Un proxy se genera a partir de los metadatos obtenidos del servicio WCF e 
incluye información sobre los tipos y métodos expuestos por el servicio. 


Pasemos a la parte práctica. Vamos a implementar un cliente WCF para con- 
sumir el servicio WCF que hemos implementado anteriormente para convertir 
grados centígrados a Fahrenheit y viceversa. Para ello, abra Visual Studio como 
administrador y cree un nuevo sitio web. Elija la plantilla Sitio web vacío 
ASP.NET, la ubicación HTTP, el lenguaje C# y denomínelo Cliente WebWCFCon- 
verTemps. Después haga clic en Aceptar. 





m 
Nuevo sitio web 








b Reciente «NET Framework 4.5 ~ Ordenar por: Predeterminado > ES 
4 Instalado ce asgi 
$ Sitio web vacío de ASP.NET Visual C# Tipo: Visual CH 
a Plantillas co Sitio web vacío 
Visual Basic 51 Sitio de ASP.NET Web Forms Visual C# 
Visual CF cs 
Ejemplos [a] Sitio web ASP.NET (Razor v1) Visual C# 


ía] 
s 


b En línea Sitio web de ASP.NET (Razor... Visual C# 


Sitio web de entidades de dat...Visual C# 


DE 


a 
+ 


Servicio WCF Visual C# 


Q 


ar 
= 
CM] 


Sitio web de informes ASP.NET Visual C# 


Ubicación web: HTTP ” 1/flocalhost/ClienteWebWCFConverTemps > | Examinar... | 


| Cancelar 
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A continuación, añada una nueva página web y diseñe la interfaz gráfica que 
mostrará esta aplicación para que tome el aspecto de la figura siguiente, en la cual 
se observa una etiqueta que pone título al formulario, otra etiqueta que especifica 
el dato que el usuario debe introducir en la caja de texto que hay a la derecha, un 
botón para convertir el valor en grados introducido en el sentido que indique la 
opción seleccionada, otro botón que realiza la misma operación que el anterior pe- 
ro dando una respuesta especificando literalmente si el resultado son grados centí- 
grados o Fahrenheit, dos botones de opción para especificar en qué sentido se 
debe realizar la conversión y una etiqueta para mostrar un mensaje en el caso de 
que se produjera algún error. 


Una vez finalizado el diseño del formulario, el resultado puede ser similar al 
mostrado en la figura siguiente: 





e http://localhost/Cli 





FConverTemps/ A ~ E © || Æ Conversión Centígrado... 


( CEES 








Conversión entre grados Centígrados y Fahrenheit 





Grados 








Convertir 














Detalles 





e) Centígrados a Fahrenheit 
Fahrenheit a Centígrados 


Error- 




















Pensemos ahora en cómo se sucederán los hechos cuando un usuario solicite 
desde un explorador que se ejecute nuestra aplicación web: 


http://localhost/ClienteWebWCFConverTemps/Default.aspx 


1. Se visualiza el formulario web de la figura anterior. 


2. El usuario selecciona el tipo de conversión que desea realizar haciendo clic 
sobre el botón de opción correspondiente. De forma predeterminada aparece 
señalada la conversión de centígrados a Fahrenheit. 


3. Escribe en la caja de texto el valor en grados que desea convertir. 


4. Hace clic en el botón Convertir. El controlador de este botón, en función del 
tipo de conversión seleccionado, invocará al método ConvCentAFahr o Conv- 
FahrACent pasando como argumento el valor de la caja de texto. 
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5. O bien hace clic en el botón Detalles. El controlador de este botón, en función 
del tipo de conversión seleccionado, invocará al método ResultadoDetallado 
pasando como argumento el objeto Detalles que devolverá el resultado deta- 
llado en función de los valores fijados para sus propiedades SonCentigrados y 
Grados. 


6. El resultado se muestra en la caja de texto. 


Para llevar a cabo el punto 4 o el 5, la aplicación cliente debe tener un medio 
de comunicarse con el servicio WCF. Esto lo permite una infraestructura (un 
proxy) que se genera cuando agregamos al proyecto una referencia al servicio. El 
proxy no es más que una clase que proporciona al cliente una representación local 
del servicio para interactuar con él. Entonces, para tener acceso a las operaciones 
proporcionadas por el servicio WCF ServWebWCFConverTemps, diríjase al menú 
Sitio web y haga clic en Agregar referencia de servicio, o bien haga clic con el 
botón secundario del ratón sobre el nombre del proyecto y seleccione esa misma 
opción. Después, por medio del diálogo que se visualiza, localice el servicio 
WCE, asigne un nombre para el espacio de nombres del proxy que se generará, 
opcionalmente puede hacer clic en el botón Avanzadas para configurar la referen- 
cia al servicio web (por ejemplo, para solicitar que se generen operaciones asín- 
cronas), y haga clic en el botón Aceptar. 





r = al 
Agregar referencia de servicio [ESA 


Para ver una lista de servicios disponibles en un servidor específico, escriba una dirección URL de servicio y 
haga clic en Ir. Para buscar servicios disponibles, haga clic en Detectar. 





Dirección: 





http://localhost/ServWebWCFConverTemps/ServWebWCFConverTemps.svc y | Ir Detectar |7 
Servicios: Operaciones: 
(0:80 ServWebWCFConverTemps || © ConvCentAFahr 
*9 IServWebWCFConverTemps 0 ConvFahrACent 


O ResultadoDetallado 





1 servicios encontrados en la dirección 
'http://localhost/ServWebWCFConverTemps/ServWebWCFConverTemps.svc'. 


Espacio de nombres: 


RefServWCFConverTemps 





| Avanzadas. | l Aceptar I Cancelar | 























El hecho de añadir la referencia de servicio al proyecto desencadenó cosas in- 
teresantes. En la carpeta de referencias web del proyecto (4pp_webReferences) se 
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ha creado una nueva subcarpeta con el mismo nombre dado al espacio de nombres 
(en nuestro caso RefServWCFConverTemps), en la que se han creado varios fiche- 
ros que puede observar en la figura siguiente. 


Por ejemplo, observamos el fichero de descubrimiento (.disco), los ficheros 
de esquemas (.xsd) y los ficheros de descripción del servicio (.wsd!). A partir de 
estos metadatos se genera un fichero de código, el cliente WCF (el proxy) que en 
nuestro ejemplo está definido por la clase ServWebWCFConverTempsClient del 
espacio de nombres RefServWCFConverTemps, y un fichero de configuración pa- 
ra el servicio. Un objeto de esta clase es el que nos permitirá acceder a las opera- 
ciones ofrecidas por el servicio. 

















Explorador de soluciones Y AX 
6 0-00 4 
Buscar en el Explorador de soluciones (Ctrl+”) P~- 





El Solución 'ClienteWebWCFConverTemps' (1 proyecto) 
4 © http://localhost/ClienteWebWCFConverTemps 
4 al App_WebReferences 


4 {“] RefServWCFConverTemps 


4 aĵ Reference.svcmap 

1) configuration.svcinfo 
“Y configuration91.svcinfo 
1) ServWebWCFConverTemps.disco 
1 ServWebWCFConverTemps.wsdl 
1) ServWebWCFConverTemps.xsd 
1) SevWebWCFConverTemps1.wsdl 
1) ServWebWCFConverTemps1.xsd 

> A Default.aspx 

Y) Web.config 
4 k 


Explorador de sol... | Vista de clases Explorador de ser... 


La clase de código que implementa el proxy y un fichero de configuración pa- 
ra el servicio podríamos también obtenerlos con la utilidad SvcUtil.exe (Service 
Model Metadata Utility Tool) que se puede encontrar en la ubicación de instala- 
ción de Windows SDK. Por ejemplo, la siguiente orden creará el fichero proxy.cs, 
que almacenará la interfaz /ServWebWCFConverTemps y las clases ServWeb- 
WCFConverTempsClient y Detalles, y el fichero app.config, que almacenará la 
configuración del cliente WCF. 


svcutil.exe /language:cs /out:proxy.cs /config:app.config 
http: //localhost/ServWebWCFConverTemps/ServWebWCFConverTemps.svc 


Podemos declarar una variable de la clase ServWebWCFConverTempsClient, 


ServWebWCFConverTempsClient cliente; 
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e ir a la definición de dicha clase (clic con el botón secundario del ratón sobre el 
nombre de la clase > Jr a definición) para observar qué métodos define. 


Configuración del cliente WCF 


Cuando generamos el proxy se configuró también el cliente WCF y se guardó di- 
cha configuración en el fichero Web.config. Esta configuración consiste en especi- 
ficar el extremo que utiliza el cliente para obtener acceso al servicio. Como ya 
dijimos anteriormente, un extremo tiene una dirección, un enlace y un contrato y 
cada uno de estos elementos debe especificarse en el proceso de configuración del 
cliente. Echemos una ojeada a esta configuración en Web.config: 


<system.serviceModel> 
<bindings> 
<basicHttpBinding> 
<binding name="BasicHttpBinding_IServWebWCFConverTemps" /> 
</basicHttpBinding> 
</bindings> 
<client> 
<endpoint 











="http://miservidor/ServWebWCFConverTemps/ 

ServWebWCFConverTemps.svc" 

="basicHttpBinding" 

bindingConfiguration="BasicHttpBinding_IServWebWCFConverTemps" 

"RefServWCFConverTemps.IServWebWCFConverTemps" 

name="BasicHttpBinding_IServWebWCFConverTemps" /> 
</client> 

</system.serviceModel> 





Finalizamos la aplicación cliente añadiendo el código fuente necesario para 
interactuar con el servicio web. 


Obtener acceso al servicio web 


Una vez agregada en el cliente la referencia al servicio WCF, el siguiente paso es 
crear un objeto de la clase ServWebWCFConverTempsClient del proxy para acce- 
der a los métodos del servicio. Cuando la aplicación cliente llama a estos méto- 
dos, es el proxy el que gestiona las comunicaciones entre la aplicación cliente y el 
servicio WCF. Según esto, edite el fichero de código subyacente Default.aspx.cs y 
agregue el código sombreado que se indica a continuación, lo que implica añadir 
el espacio de nombres RefServWCFConverTemps. También, hemos iniciado la 
etiqueta de mensajes de error con una cadena vacía, para que, mientras no haya 
errores, no se muestre nada al usuario. 


public partial class _Default : System.Web.UlI.Page 
( 
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private ServWebWCFConverTempsClient cliente = null; 
protected void Page_lLoad(object sender, EventArgs e) 
( 

etError.Text = ""; 

cliente = new ServWebWCFConverTempsClient(); 


Sólo queda realizar las llamadas a los métodos del servicio necesarios en cada 
caso. Éstas se realizarán desde los métodos que respondan al evento Click de los 
botones Convertir y Detalles. Por lo tanto, haga doble clic en estos botones para 
agregar a Default estos manejadores de eventos. Después, complételos como se 
indica a continuación: 


protected void btConvertir_Click(object sender, EventArgs e) 
( 


etError.Text = ""; 


// Obtener el valor escrito en la caja de texto 
try 
( 
nGrados = Convert.ToDouble(ctGrados.Text); 
// Realizar la conversión invocando al método correspondiente 
if (boConvCF.Checked) 
{ 
ctGrados.Text = 
Convert.ToString(cliente.ConvCentAFahr(nGrados)); 
} 
if (boConvFC.Checked) 
{ 
ctGrados.Text = 
Convert.ToString(cliente.ConvFahrACent(nGrados)); 





} 
) 
catch (Exception exc) 
( 

etError.Text = exc.Message; 


) 





} 


protected void btDetalles_Click(object sender, EventArgs e) 
{ 
etError.Text = ""; 
try 
{ 
nGrados = Convert.ToDouble(ctGrados.Text); 
Detalles detalle = new Detalles(); 
detalle.Grados = nGrados; 
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detalle.SonCentigrados = boConvCF.Checked; 
ctGrados.Tlext = cliente.ResultadoDetallado(detalle).Literal; 
) 
catch (Exception exc) 
( 
etError.Text = exc.Message; 
) 


Ambos métodos utilizan la variable nGrados para almacenar el valor introdu- 
cido por el usuario en la caja de texto. Por lo tanto, defina esta variable como atri- 
buto de la clase: 


public partial class _Default : System.Web.UlI.Page 

( 
private ServWebWCFConverTempsClient cliente = null; 
private double nGrados; 


Obsérvese que, en ambos métodos, se toma el valor proporcionado por el 
usuario en la caja de texto ctGrados y, utilizando el objeto de la clase ServWeb- 
WCFConverTempsClient, se llama al método adecuado del servicio WCF por 
medio del método correspondiente en el proxy. El resultado, valor devuelto por el 
servicio WCF, se muestra en la misma caja de texto. 


Ejecución asíncrona 


Según vimos anteriormente, cuando se genera el proxy de un servicio WCF existe 
la posibilidad de incluir llamadas asíncronas a los métodos que ofrece el servicio. 
Esto permite que al consumirlo desde una aplicación cliente se puedan hacer lla- 
madas asincronas al mismo, con el fin de dejar que se siga ejecutando la aplica- 
ción sin necesidad de que el hilo de ejecución tenga que estar a la espera de que 
terminen las operaciones (que pueden ser costosas) en dicho servicio. A modo de 
ejemplo, suponiendo que al generar el proxy solicitamos que se generaran opera- 
ciones asíncronas, podemos distinguir, entre otros, los siguientes métodos: 


public void ConvCentAFahrAsyne(double gCent) 
[ 
this.ConvCentAFahrAsync(gCent, null); 
} 


public void ConvFahrACentAsync(double gFahr) 
( 




















this.ConvFahrACentAsync(gFahr, null); 


1 
f 
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Cuando se invoca a estos métodos para su ejecución y esta finaliza, se gene- 
ran los eventos ConvCentAFahrCompleted y ConvFahrACentCompleted, respec- 
tivamente, definidos también en el proxy. 


Una cosa más: para ejecutar una página web .aspx que inicia una operación 
asincrona, esta debe tener el atributo Async establecido a true: 


<%@ Page Asyne="truel ... 


Según esto, también podríamos escribir los métodos btConvertir_Click y 
btDetalles_Click para que realicen llamadas a los métodos asíncronos indicados 
anteriormente. Una vez realizada la llamada al método asincrono, el control se 
devuelve a la aplicación para que el usuario pueda seguir interactuando con la 
misma. Cuando el servicio devuelva los datos que solicitamos, lo notificará a la 
aplicación generando el evento ... Completed correspondiente. Entonces, tenemos 
que interceptar este evento para poder recoger el resultado. Esto es lo que hace el 
código indicado a continuación: 


public partial class _Default : System.Web.UlI.Page 

( 
private ServWebWCFConverTempsClient cliente = null; 
private double nGrados; 


protected void Page_lLoad(object sender, EventArgs e) 
( 
etError.Text = 
cliente = new ServWebWCFConverTempsClient(); 


cliente.ConvCentAFahrCompleted += 
new EventHandler<ConvCentAFahrCompletedEventArgs>( 
cliente _ConvCentAFahrCompleted):; 
cliente.ConvFahrACentCompleted += 
new EventHandler<ConvFahrACentCompletedEventArgs>( 
cliente _ConvFahrACentCompleted):; 
cliente.ResultadoDetalladolompleted += 
new EventHandler<ResultadoDetalladoCompletedEventArgs>( 
cliente _ResultadoDetalladoCompleted); 





























Cada uno de estos controladores de eventos indica que se debe llamar al 
método especificado cuando el servicio devuelva los datos solicitados. Por lo 
tanto, definimos estos métodos en el ámbito de la clase Default de forma que no 
solo proporcionen el resultado, sino que también controlen los errores que puedan 
ocurrir, como que el servicio no se encuentre disponible o que no esté configurado 
adecuadamente o que la dirección del mismo no sea correcta. Para controlar estos 
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errores es preciso interrogar la propiedad Error del parámetro que proporciona 
los datos del evento, antes de obtener acceso a la propiedad Result que 
proporciona los datos solicitados. En otro caso, si se accede a la propiedad Result 
cuando se ha producido un error, se lanzará una excepción. El código mostrado a 
continuación muestra la implementación de estos controladores en los términos 
expuestos. 


private void cliente _ConvCentAFahrCompleted(object sender, 
ConvCentAFahrCompletedEventArgs e) 
( 


1f (e.Error != null) 
( 
etError.Text = "Error en la conversión de grados C a F"; 
) 
else 


( 
ctGrados.Tlext = Convert.ToString(e.Result); 
) 
) 


private void cliente_ConvFahrACentCompleted(object sender, 
ConvFahrACentCompletedEventArgs e) 
( 


if (e.Error != null) 
( 
etError.Text = "Error en la conversión de grados F a C"; 
) 
else 


( 
ctGrados.Text = Convert.ToString(e.Result); 
) 
) 


private void cliente_ResultadoDetalladoCompleted(object sender, 
ResultadoDetalladoCompletedEventArgs e) 
( 


if (e.Error != null) 
( 
etError.Text = "Error al obtener detalles del resultado"; 
) 
else 


( 
ctGrados.Tlext = e.Result.lLiteral; 
) 
) 


Sólo queda realizar las llamadas a los métodos asíncronos a los que nos he- 
mos referido anteriormente. Estas se realizarán desde los métodos que respondan 
al evento Click de los botones Convertir y Detalles. Por lo tanto, haga doble clic 
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en estos botones para agregar a Default estos manejadores de eventos. Después, 
complételos como se indica a continuación: 


protected void btConvertir_Click(object sender, EventArgs e) 
{ 


etError.Text = ""; 


// Obtener el valor escrito en la caja de texto 
try 
( 
nGrados = Convert.ToDouble(ctGrados.Text); 
// Realizar la conversión invocando al método correspondiente 
if (boConvCF.Checked) 
{ 
cliente.ConvCentAFahrAsync(nGrados); 
} 
if (boConvFC.Checked) 
{ 
cliente.ConvFahrACentAsync(nGrados); 
} 
} 
catch (Exception exc) 
{ 
etError.Text = exc.Message; 
) 
) 


protected void btDetalles_Click(object sender, EventArgs e) 
( 
etError.Text = ""; 
try 
( 
nGrados = Convert.ToDouble(ctGrados.Text); 
Detalles detalle = new Detalles(); 
detalle.Grados = nGrados; 
detalle.SonCentigrados = boConvCF.Checked; 
cliente.ResultadoDetalladoAsync(detalle); 
} 
catch (Exception exc) 
{ 
etError.Text = exc.Message; 
) 
) 


El proceso descrito de llamadas asíncronas a servicios web es aplicable tanto 
a clientes Windows como a clientes web. Su aplicación dependerá, evidentemen- 
te, de las tareas que la aplicación realice y de cómo las lleve a cabo. 
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Lo anterior pone de manifiesto que las aplicaciones que realizan simultánea- 
mente muchas tareas, con frecuencia requieren un diseño basado en subprocesos 
(hilos). Precisamente, el modelo asincrónico basado en eventos pone a disposición 
del usuario las ventajas de las aplicaciones multiproceso, al tiempo que evita mu- 
chos de los problemas complejos inherentes a este tipo de diseño. Utilizar una cla- 
se que admita este modelo permite: 


e Realizar tareas que exigen mucho tiempo, en segundo plano sin interrumpir la 
aplicación. 

e Ejecutar simultáneamente varias operaciones y recibir la notificación corres- 
pondiente cuando finalice cada una de ellas. 

e Esperar a que estén disponibles los recursos sin detener (colgar) la aplicación. 

e Establecer comunicación con operaciones asíncronas pendientes utilizando el 
modelo habitual de eventos y delegados. 


Seguridad en WCF 


WCF utiliza los mismos conceptos utilizados para generar aplicaciones seguras y 
distribuidas con las tecnologías existentes, por ejemplo, HTTPS, autenticación in- 
tegrada de Windows, o formularios para autenticar a los usuarios y también ex- 
tiende la seguridad distribuida más allá de los dominios de Windows mediante 
mensajes SOAP seguros. En WCF la seguridad comienza en el enlace (por ejem- 
plo, wsHttpBinding utiliza el transporte HTTP, HTTPS y proporciona seguridad 
para mensajes, transacciones, etc.) y continúa con las infraestructuras de seguri- 
dad existentes (por ejemplo SSL) y con los métodos de autenticación existentes 
(por ejemplo, autenticación Windows), entre otras formas de seguridad. En el ca- 
pítulo titulado Seguridad de aplicaciones ASP.NET serán ampliados estos concep- 
tos. 


SERVICIOS WEB Y LINQ 


En el capítulo de Formularios web vimos cómo utilizar el control EntityData- 
Source para administrar la mayor parte de la lógica necesaria para consultar el 
modelo de objetos representativo de una base de datos, pasar los datos al explora- 
dor, recuperarlos y enviarlos al DbContext, que, a continuación, actualizaba la 
base de datos. Esto es, EntityDataSource fue utilizado en la capa de presentación 
para controlar la transferencia de datos entre la interfaz de usuario, página web 
ASP.NET, y Entity Framework (EF) en el de nivel intermedio. Este nivel inter- 
medio definía una interfaz que especificaba cómo el nivel de presentación podía 
obtener acceso a los datos, por ejemplo, a través del DbContext. 
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Pues bien, utilizando un servicio web en una aplicación de N niveles, el nivel 
intermedio contendrá, centrándonos ya en Entity Framework, el contexto de obje- 
tos y las clases de entidad y, también, definirá la interfaz con los métodos que en- 
volverán las consultas de LINQ que los clientes utilizarán para recuperar, insertar 
y actualizar datos. Por otra parte, el nivel de presentación debe contar con las de- 
finiciones de tipo para los datos que recibirá desde el nivel intermedio; por ejem- 
plo, el nivel de presentación podrá generar los tipos a partir de la infraestructura 
de un servicio WCF. Esos tipos pueden ser clases de entidad propiamente dichas o 
clases especiales que envuelvan solo ciertos campos de las clases de entidad. 


į Aplicación web distribuida 





Definiciones de tipos locales 


Las entidades se 
asocian a 
DbContext en 
la deseriación 

















Las entidades se 
desasocian en la 
seriación 









: ¿Nivel intermedio 





Capa de servicio WCF 


Objetos de negocio y LINQ 


Modelo de entidades 


DbContext 







ase de dato 
relacional 


En la figura anterior se puede observar que la capa de presentación llamará a 
los métodos de la interfaz remota de nivel intermedio y, en este nivel, la capa de 
acceso a datos (DAL, Data Access Layer) ejecutará las consultas o procedimien- 
tos almacenados asignados a métodos de DbContext. El nivel intermedio devuel- 
ve los datos a los clientes generalmente como representaciones XML de entidades 
u objetos. 
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En el nivel intermedio, los objetos de negocio y las consultas sobre el modelo 
de objetos se encuentran en la capa de negocio (BLL, Business Logic Layer) y las 
clases de entidad y el contexto de objetos en la capa de acceso a datos (DAL). 
Evidentemente, algunas de estas capas intermedias son opcionales, esto es, el que 
estén o no dependerá del diseño que se haga en cada caso. En este nivel, el con- 
texto de objetos realiza el seguimiento del estado de las entidades que son creadas 
(véase el capítulo LINO) y que están asociadas a dicho contexto. Sin embargo, 
una vez que las entidades se envían a otro nivel a través de la seriación, quedan 
desasociadas, lo cual significa que el DbContext ya no realiza el seguimiento de 
su estado, por eso, las entidades que el cliente devuelve para actualizar la base de 
datos se tienen que volver a asociar al contexto de objetos para que Entity Fra- 
mework pueda enviar los cambios a dicha base de datos. 


Cuando los datos vayan a ser grabados en la base de datos podría haber pro- 
blemas de concurrencia o simultaneidad que, por ejemplo, podríamos solucionar 
utilizando valores originales para las comprobaciones de simultaneidad optimista 
y Entity Framework admite la comprobación de simultaneidad optimista basada 
en valores originales. 


Arquitectura de N capas lógicas y N niveles físicos 


Como ejemplo vamos a construir a continuación una aplicación de N capas (N- 
Layer architecture), generalmente, tres o más capas lógicas: presentación, lógica 
de negocio y acceso a datos, y N niveles (N-Tier architecture), cada nivel se refie- 
re a una parte de la aplicación que se encuentra físicamente en un equipo inde- 
pendiente. De aquí que no todas las aplicaciones de N capas serán de N niveles, 
pero sí todas las aplicaciones de N niveles deberán estar diseñadas como de N ca- 
pas. Por ejemplo, según lo expuesto, la capa de presentación y lógica de negocio 
propia de esta, de la aplicación que vamos a desarrollar, podrá estar desplegada en 
un servidor con IIS (llamemos a esta parte “nivel de cliente”) y se comunicará con 
la base de datos a través de un servicio WCF que podrá estar desplegado, por 
ejemplo junto a la base de datos, en otro servidor (llamemos a esta otra parte “ni- 
vel de servidor”). La figura siguiente clarifica lo expuesto: 
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Servidor 1 


Usuario 1 


Servidor 2 


Usuario 2 


El despliegue propuesto para la aplicación requiere que el nivel de cliente se 
comunique con el nivel de servidor a través de un servicio WCF, por ejemplo. 
Ahora, cuando el cliente haga una petición al servidor para obtener unos determi- 
nados datos, el servicio WCF hará una consulta a la base de datos y mantendrá el 
resultado como una entidad en el contexto de Entity Framework. A continuación, 
la entidad obtenida será enviada al cliente, para lo cual antes será desconectada 
(Detach) del contexto de objetos (ya que posteriormente tendrá que ser conectada 
de nuevo, y conectar una entidad no desconectada puede producir un error) y se- 
riada por WCF. De esta forma, trabajando de forma desconectada, los datos de las 
tablas de la base de datos no serán bloqueados mientras el usuario trabaja en el 
cliente, lo que mejora la escalabilidad. 


En el cliente, tal vez el usuario necesite modificar los datos de la entidad ob- 
tenida y enviar los cambios al servidor para que sean registrados en la base de da- 
tos. En este caso, podrían surgir problemas de simultaneidad, que podríamos 
solucionar, según dijimos anteriormente, utilizando los valores originales para las 
comprobaciones de simultaneidad optimista. 


Crear la base de datos 


Empecemos entonces por crear una base de datos que, en nuestro caso, vamos a 
llamar bd_ telefonos3 y que va a tener una tabla denominada telefonos: 


CREATE TABLE telefonos 
( 
idpersona INTEGER IDENTITY(1,1) PRIMARY KEY, 
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nombre VARCHAR(16) NOT NULL, 
apellidol VARCHAR(12) NOT NULL, 
apellido2 VARCHAR(12), 
direccion VARCHAR(30) NOT NULL, 
telefono VARCHAR(12) NOT NULL, 
observaciones VARCHAR(240), 

foto VARCHAR(30) 














La propiedad IDENTITY define la columna como una columna de identidad. 
Las columnas de identidad se utilizan normalmente con las restricciones PRI- 
MARY KEY como identificadores de fila únicos de la tabla. En este caso, deben 
especificarse el valor de iniciación y el incremento, o ninguno, en cuyo caso se 
asumen los valores (1,1). Esto quiere decir que cuando se agregue una fila nueva a 
la tabla, el motor de base de datos proporciona un valor incremental único para la 
columna. En nuestro caso, el primer idpersona será 1, y el incremento, 1. 


En el campo foto vamos a almacenar la ruta de la foto de esa persona, que al- 
macenaremos, por ejemplo, en una carpeta fotos en el sitio web. ASP.NET pro- 
porciona un control FileUpload, compuesto por una caja de texto y un botón 
examinar, que permite a los usuarios seleccionar un fichero en el cliente y cargar- 
lo en el servidor web. Podríamos también haber optado por definir el campo foto 
de tipo VARBINARY(MAX), pero esta forma de proceder presenta más dificul- 
tades a la hora de recuperar la imagen para mostrarla, y la base de datos ocupa 
mucho más espacio. 


El tipo binary/(n)] permite definir tipos de datos binarios de longitud fija, y 
varbinary[(n|max)], variable. Utilice binary cuando los tamaños de las entradas 
de datos de columna sean coherentes, varbinary cuando los tamaños varíen consi- 
derablemente, y varbinary(max) cuando superen los 8.000 bytes. 


No olvide dar permisos al usuario NT AUTHORITY Servicio de Red para que 
pueda acceder a esta base de datos. 


Crear el servicio WCF 


Una vez creada la base de datos, pasamos a crear el servicio WCF. Para ello, 
abrimos Visual Studio y creamos un nuevo sitio web denominado ServicioWCF- 
Linq utilizando la plantilla Servicio WCF. 


A continuación, abra el explorador de bases de datos/explorador de servidores 
y añada una conexión a la base de datos bd_telefonos3. Después, añada el modelo 
de entidades correspondiente a la base de datos. Para ello, abra el asistente para el 
EDM y agregue al proyecto un nuevo elemento de tipo ADO.NET Entity Data 
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Model denominado Model.edmx. Se generará la clase del contexto de objetos 
bd _telefonos3Entities y la clase de entidad telefonos, ambas pertenecientes al es- 
pacio de nombres bd _telefonos3 Model. 


ESE Y AX 
a 00 t-A 
<Búsqueda> - P 
b El Referencias del proyecto a 
» Y 4 od_telefonos3Entities 
b f$ CompositeType 
b +o IService 
b % Service 
> ~ EED z 


Como siguiente paso, definimos el contrato de servicio y el contrato de datos. 
El contrato de servicio declara las siguientes operaciones: obtener la lista de ape- 
llidos y teléfonos de la tabla telefonos, obtener la fila de la tabla telefonos corres- 
pondiente a un teléfono determinado, actualizar una fila, agregar una nueva fila y 
borrar una fila de la tabla telefonos. Para obtener la lista de apellidos y teléfonos 
el contrato de servicio utiliza en sus operaciones el tipo compuesto Detalles, se- 
gún se muestra a continuación: 


[ServiceContrac 


t] 


public interface IService 


{ 


[Operation 
List<Detal 
[Operation 

















) 


Operati 
void ActualizarlTf 





[Operati 
void AgregarT 





Operati ] 
void BorrarTfno(telefono entidad); 


on 


on 





on 


Co 
les> 0b 
Contract] 


Co 


Co 


Co 


[DataContract] 
public class Detalles 


( 





telefono ObtenerT 


fno( 





tract] 


tract] 


n 


tract] 





tract] 


fno(string tf); 


enerTfnos(); 





o(tel efono entidad); 


el efono entidad); 





private string _apellidol; 
private string _telefono; 
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public Detallesístring ap, string tf) 
( 
_apellidol = ap; 
_telefono = tf; 
) 


[DataMember] 
public string apellidol 
( 
get { return _apellidol; } 
set { _apellidol = value; } 
) 





[DataMember] 

public string telefono 

( 
get { return _telefono; } 
set [ _telefono = value; ) 


Después de definir el contrato de servicio y sus operaciones, y de definir el 
contrato de datos, definimos la clase del servicio. En nuestro caso, se trata de la 
clase Service que implementa la interfaz /Service, pero antes de pasar a definir es- 
ta clase, vamos a escribir otra clase en la capa BLL, que utilizando EF y LINO to 
Entities defina las operaciones de consulta y actualización que deseamos realizar 
sobre la base de datos. Entonces, como siguiente paso, añada una nueva clase al 
sitio web, denominada telefonosBll, y complétela como se indica a continuación 
(para organizar los componentes del sitio web, el autor añadirá esta clase en la 
carpeta App_CodelBLL): 


public class telefonosBll 
( 
public telefonosB11() {} 


public telefono ObtenerTfnoBll(string tf) 
( 
using (bd_telefonos3Entities contexto = 
new bd_telefonos3Entities()) 
( 
var consulta = from tfno in contexto.telefonos 
where tfno.telefonol == tf 
select tfno; 
1f (consulta.Count() == 0) return null; 
telefono registro = consulta.First(); 
return registro; 








public List<Detalles 
( 
using (bd_telefono 
new bd_tele 

( 
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> ObtenerTfnosBl1() 


s3Entities contexto = 
fonos3Entities()) 


var consulta = from persona in contexto.telefonos 


S 





List<Detalles> 1 
foreach (var e 1 
( 
lista.Add(new 
) 
return lista; 
) 
) 


elect new { 

persona.apellidol, persona.telefonol }; 
ista = new List<Detalles>(); 

n consulta) 


Detalles(e.apellidol, e.telefonol)); 


public void ActualizarTfnoB11(telefono entidad) 


( 


// Obtener una entidad conectada con la clave especificada, 


// aplicar los ca 
) 


public void Agregar! 
( 


bios y salvarlos en la base de datos 


TfnoB11(telefono entidad) 


// Si no hay una entidad con el mismo teléfono, añadirla 
// al contexto actual y salvar los cambios 


) 


public void BorrarT 
( 


fnoB11(telefono entidad) 





// Obtener la enti 


dad conectada correspondiente, borrarla 


// del contexto actual y salvar los cambios 


) 





private telefono Existelelefono(telefono entidad, 
bd_telefonos3Entities contexto) 


( 
try 
( 


var consulta = from tfno in contexto.telefonos 
where tfno.telefonol == entidad.telefonol 
select tfno; 

telefono registro = consulta.First(); 


return registro; 


, 


) 
catch (Exception) 
( 

return null; 


) 
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Echemos un vistazo a los métodos de la clase telefonosBll. El método Obte- 
nerTfnoBll utilizando LINQ devuelve una entidad telefono (la correspondiente al 
teléfono pasado como argumento), ObtenerTfnosBll utilizando LINQ devuelve 
una lista con el primer apellido y el teléfono de todas las filas de la tabla telefonos, 
ActualizarTfnoBll permite actualizar una fila de la tabla telefonos (la correspon- 
diente a la entidad pasada como argumento), AgregarTfnoBll permite agregar a la 
tabla telefonos una nueva fila, la correspondiente a la entidad pasada como argu- 
mento, y BorrarTfmoBll permite borrar la fila especificada de la tabla telefonos. 
Lo importante a tener en cuenta es que: estamos devolviendo a las capas superio- 
res (servicio y capa de presentación) y recibiendo de ellas conjuntos de datos des- 
conectados o desasociados. Esto significa, con respecto a EF, que estamos 
trabajando en un contexto (objeto DbContext) de “corta duración”. Entonces, 
cuando finalicemos el ciclo (se envió al nivel de presentación una entidad tele- 
fono, se modificó y se devolvió al nivel de servidor), tendremos que volver a co- 
nectar la entidad devuelta por el cliente con estado desconectada (Detached) que 
se actualizó al margen del DbContext. Éste es un escenario muy común cuando 
estamos utilizando arquitecturas de N capas y N niveles. 


Resumiendo, al seriar una entidad, por ejemplo un objeto telefono, para en- 
viarla a través de la red al nivel de cliente, esa entidad se desconecta de su contex- 
to de datos, lo que impide realizar un seguimiento de los cambios en sus datos o 
en sus relaciones con otros objetos. Esto no presenta ningún problema mientras el 
cliente solo esté leyendo los datos, pero sí cuando se trate de actualizar esos datos 
en la base de datos; en este caso, antes de llamar al método SaveChanges del 
DbContext actual habrá que asociar la entidad a este contexto de datos. 


Volviendo a nuestro código, las operaciones que va a realizar el servicio WCF 
serán seriar y devolver una o más entidades desconectadas, actualizar la base de 
datos con los datos de una entidad, añadir nuevas entidades y borrar una o más en- 
tidades. Según lo expuesto, la clase que define el contrato de servicio puede ser la 
siguiente: 


public class Service : IService 
( 
public telefono ObtenerTfno(string tf) 
( 
return new telefonosBl11().0ObtenerTfnoB11(tf); 
) 


public List<Detalles> ObtenerTfnos() 
( 





return new telefonosBl11().0btenerTfnosBl1(); 
) 
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public void ActualizarTfno(telefono entidad) 
( 

new telefonosB11().ActualizarTfnoBll(entidad); 
) 


public void AgregarTfno(telefono entidad) 
( 

new telefonosB11().AgregarTfnoB11(entidad); 
) 


public void BorrarTfno(telefono entidad) 
( 
new telefonosB11().BorrarTfnoB11(entidad):; 
) 
) 


Obsérvese que los métodos de esta clase se limitan a invocar a sus homólogos 
en la capa BLL. 


Posteriormente, una aplicación cliente, por ejemplo un formulario ASP.NET, 
consumirá el servicio WCF y mostrará los datos de una entidad telefonos, la de 
aquella que el usuario seleccione de la lista. A la vista de los datos, el usuario po- 
drá cambiar algunos de ellos con el fin de actualizar esa entidad y enviarla de 
nuevo al servidor para actualizar la base de datos. No olvide que la aplicación 
cliente estará trabajando con una entidad desconectada, por lo que no hay un se- 
guimiento de los cambios que se realicen sobre ella o sobre sus relaciones con 
otros objetos. 


Para enviar la entidad modificada al nivel de servidor, el cliente invocará al 
método ActualizarTfno del servicio WCF pasando como argumento dicha entidad, 
que a su vez invoca al método de negocio ActualizarTfnoBll de la capa BLL que 
tiene como fin conectar de nuevo la entidad recibida al contexto de objetos actual 
e invocar al método SaveChanges de este contexto para almacenar los cambios 
en la base de datos, ya que SaveChanges solo trabaja sobre las entidades asocia- 
das al contexto que lo invoca, porque el seguimiento que este realiza sobre ellas le 
permite conocer los cambios que hay que registrar. 


public void ActualizarTfnoB11(telefono entidad) 
( 
using (bd_telefonos3Entities contexto = 
new bd_telefonos3Entities()) 
( 
try 
( 
telefono actual = contexto.telefonos.Find(entidad.idpersona); 
if (actual != null) // si existe en el contexto... 


( 
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contexto.Detachí(actual); 
// Detach: método extensor en bd_telefonos3EntitiesEx 

// El estado de "entidad" es Detached 
contexto.telefonos.Attach(entidad):; 
// Ahora, el estado de "entidad" es Unchanged 
contexto.Entry(entidad).State = EntityState.Modified; 
contexto.SaveChanges(); 

) 


1 
J 


catch (Exception ex) 
{ 
System.Diagnostics.Debug.WriteLine(ex.InnerException.Message); 


Pero ¿por qué no conectamos directamente entidad con el método Attach de 
DbSet en lugar de desconectar primero actual? Porque si lo prueba, no funciona, 
debido a que ya existe un objeto con la misma clave en ObjectStateManager 
(véase el apartado El seguimiento de cambios en el capítulo LINO). Una vez co- 
nectada la entidad, pasa al estado Unchanged; entonces, para que los cambios 
puedan ser guardados por SaveChanges, tenemos que modificar el estado de esa 
entidad a Modified. 


Observe en ActualizarTfnoBll la llamada al método Detach; se trata de un mé- 
todo de ObjectContext. Para disponer de este método en DbContext lo vamos a 
implementar como un método extensor de la clase bd" telefonos3Entities derivada 
de DbContext. Para ello, añada en App _CodelBLL una nueva clase static deno- 
minada bd_telefonos3EntitiesEx y complétela según se indica a continuación. La 
solución completa puede verla en Cap17|ServicioWCFLinq. 


public static class bd_telefonos3EntitiesEx 


{ 
public static ObjectContext ObtenerO0bjectContext(this DbContext contex) 
( 


return (contex as IO0bjectContextAdapter).ObjectContext; 
) 


public static void Detach(this DbContext contex, object entity) 
( 

ObtenerO0bjectContextí(contex).Detach(entity); 
} 


Para enviar una nueva entidad al nivel de servidor, el cliente invocará al mé- 
todo AgregarTfno del servicio WCF pasando como argumento dicha entidad, que 
a su vez invoca al método de negocio AgregarTfnoBll de la capa BLL que tiene 
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como fin verificar que no hay ya una entidad con el mismo teléfono, añadir la en- 
tidad al contexto actual y llamar a SaveChanges para almacenar los cambios en la 
base de datos. 


public void AgregarTlfnoBll(telefono entidad) 
( 
using (bd_telefonos3Entities contexto = 
new bd_telefonos3Entities()) 
( 
if (ExisteTelefonolentidad, contexto) != null) 
throw new Invalid0perationException("El teléfono existe"); 
contexto.telefonos.Add(entidad); 
try 
( 
contexto.SaveChanges(); 
) 
catch (Exception ex) 
( 
System.Diagnostics.Debug.WritelLine(ex.InnerException.Message); 


) 








Para enviar al nivel de servidor la entidad a eliminar, el cliente invocará al 
método BorrarTfnho del servicio WCF pasando como argumento dicha entidad, 
que a su vez invoca al método de negocio BorrarTfnoBll de la capa BLL que tiene 
como fin obtener la entidad conectada correspondiente, borrarla del contexto ac- 
tual y llamar a SaveChanges para almacenar los cambios en la base de datos. 


public void BorrarTfnoBl11(telefono entidad) 
( 
using (bd_telefonos3Entities contexto = 
new bd_telefonos3Entities()) 
( 
try 
( 
if (Centidad = Existelelefonolentidad, contexto)) == null) 
throw new InvalidOperationException("El teléfono no existe"); 
contexto.telefonos.Remove(entidad); 
contexto.SaveChanges(); 
) 
catch (DbUpdateConcurrencyException ex) 
( 
throw new Invalid0perationException( 
"El elemento especificado no puede ser borrado"); 
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Cliente WCF 


Una vez finalizado el nivel de servidor, vamos a pasar a implementar un cliente 
que nos permita utilizar la funcionalidad proporcionada por el servicio WCF. Para 
ello, siga los pasos explicados anteriormente en el apartado Implementar un clien- 
te WCF de este mismo capítulo. 


Empecemos por crear un nuevo sitio web denominado ClienteWCFLinq basa- 
do en la plantilla Sitio web vacio de ASP.NET. Después, añada una página web. 


Añada también al proyecto una carpeta fotos donde estarán guardadas las fo- 
tos correspondientes a las rutas definidas por el campo foto de cada una de las 
personas almacenadas en la base de datos bd telefonos3. 


A continuación diseñe la página según la figura mostrada a continuación. Ob- 
serve que la página incluye: 


e Un componente ObjectDataSource que recibirá el valor devuelto por el mé- 
todo ObtenerTfnos de la interfaz del servicio WCF y que será utilizado como 
origen de datos de la lista desplegable. 


e Una lista DropDownList que mostrará el primer apellido de todas las filas de 
la tabla telefonos de la base de datos y almacenará como valor el teléfono co- 
rrespondiente. 


e Un componente Image para mostrar la foto de la persona seleccionada. 


e Un conjunto de cajas de texto, con las etiquetas correspondientes, para mos- 
trar los datos de la fila correspondiente al elemento seleccionado en la lista. 
Esto implica poner la propiedad AutoPostBack de la lista a valor true. 


e Un componente FileUpload para modificar la foto. 


e FEl usuario podrá modificar los datos de las cajas con la finalidad de registrar 
los cambios en la base de datos. Para enviar estos cambios, añada al formula- 
rio un botón Actualizar. 


e También podrá modificar los datos de las cajas con la finalidad de añadir una 
nueva fila a la tabla telefonos de la base de datos. Para enviar los datos de la 
nueva fila, añada al formulario un botón Añadir. 
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e Y también podrá borrar la fila de la base de datos correspondiente a los datos 
mostrados. Para enviar los datos de la fila a borrar, añada al formulario un bo- 
tón Borrar. 


El control ObjectDataSource es muy útil a la hora de enlazar un control web, 
como una lista desplegable o una tabla, con un objeto de negocio, como por ejem- 
plo un servicio web XML. El modelo de este objeto es similar al del control 
SqlDataSource. En lugar de una propiedad ConnectionString, ObjectData- 
Source presenta una propiedad TypeName que especifica el tipo del objeto 
(nombre de la clase) que hay que crear para realizar las operaciones con los datos. 
También, análogamente a las propiedades de SqlDataSource que hacen referen- 
cia a las órdenes SQL, el control ObjectDataSource presenta propiedades tales 
como SelectMethod, UpdateMethod, InsertMethod y DeleteMethod para es- 
pecificar los métodos que se deberán invocar para ejecutar las operaciones para la 
selección, actualización, eliminación y creación de registros de datos. Se puede 
controlar el ciclo de vida del objeto a través de los eventos ObjectCreating, Ob- 
jectCreated y ObjectDisposing. 


Una vez finalizado el diseño del formulario, el resultado puede ser similar al 
mostrado en la figura siguiente: 

















a 
O Æ http://localhost/ClienteWCFLing/Default.a: O ~ B È | Æ Cliente WCF 


Listado por el primer apellido: 
Ceballos v] 

















Foto: 


Nombre y apellidos: 

Francisco Ceballos Femández 
Dirección: 
Boston, U.S.A. | 
Teléfono: 
111555999 
Observaciones: 
CEO Evermedia 
Cambiar foto: 









































Examinar. 














Actualizar Añadir Borrar 





























m A 





Pensemos ahora en cómo se sucederán los hechos cuando un usuario solicite 
desde un explorador que se ejecute nuestra aplicación web: 


http://Tlocalhost/ClienteWCFLinq/Default.aspx 
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Se visualiza el formulario web. 
El usuario selecciona una persona de la lista. 


Las cajas de texto muestran los datos correspondientes a esa persona. 


2 9 INE 


El usuario quizás haya solicitado esos datos como simple información o por- 
que desea realizar alguna actualización o borrar el registro correspondiente. 
También puede optar por añadir un registro nuevo. 


5. En el caso de realizar una actualización, modificará en las cajas de texto los 
datos implicados y hará clic en el botón Actualizar. Si lo que desea es borrar 
el registro mostrado, hará clic en el botón Borrar y si lo que quiere es añadir 
un nuevo registro, introducirá los datos en las cajas y hará clic en el botón 
Añadir. 


Para llevar a cabo los puntos anteriores, el cliente debe agregar una referencia 
al servicio. Para ello, diríjase al menú Sitio web y haga clic en Agregar referencia 
de servicio, o bien haga clic con el botón secundario del ratón sobre el nombre del 
proyecto y seleccione esa misma opción. Después, por medio del diálogo que se 
visualiza, localice el servicio WCF, asigne un nombre (por ejemplo, RefServicio- 
Tfnos) para el espacio de nombres del proxy que se generará y haga clic en el bo- 
tón Aceptar: 


r a a) 
Agregar referencia de servicio o 


Para ver una lista de servicios disponibles en un servidor especifico, escriba una dirección URL de servicio y 
haga dlic en Ir. Para buscar servicios disponibles, haga clic en Detectar. 








Dirección: 
http://localhost/ServicioWCFLing/Service.svc hd Ir Detectar |” 
Servicios: Operaciones: 
0:89 Service 9 ActualizarTfno 
*9 IService O AgregarTfno 


O BorrarTíno 
© ObtenerTfno 
© ObtenerTínos 











1 servicios encontrados en la dirección 'http://localhost/ServicioWCFLing/Service.svc'. 


Espacio de nombres: 


RefServicioTínos 


Avanzadas... Cancelar 




















CAPÍTULO 17: SERVICIOS WEB 927 


Continuando con la aplicación, configure el control origen de datos Object- 
DataSourcel para que proporcione los datos recuperados por el método Obte- 
nerTfnos del servicio web: 


<asp:ObjectDataSource ID="0bjectDataSourcel" runat="server" 
SelectMethod="0btenerTfnos" 
TypeName="RefServiciolfnos.ServiceClient"> 
</asp:0bjectDataSource> 





Llenar la lista 


Una vez configurado el objeto de negocio ObjectDataSourcel, configure la lista 
para que su origen de datos sea este objeto, muestre apellido] y almacene el valor 
telefono: 


<asp:DropDownList ID="DropDownList1" runat="server" 
AutoPostBack="True" DataSourcelD="0bjectDataSourcel" 
DatalextField="apellido1" DataValueField="telefono" Width="220px" 
OnDataBound="DropDownList1_DataBound"> 
OnSelectedIndexChanged="DropDownListl1_SelectedIndexChanged" 
</asp:DropDownList> 


Cuando se inicie esta aplicación web y la lista se haya llenado con los datos 
proporcionados por ObjectDataSourcel, se generará el evento OnDataBound 
que interceptaremos para iniciar las cajas de texto con los datos del elemento que 
muestra la lista inicialmente: 


protected void DropDownListl_DataBound(object sender, EventArgs e) 
( 
ActualizarCajasDeTexto(); 


} 


private void ActualizarCajasDeTexto() 
{ 
cliente = new RefServicioTfnos.ServiceClient(); 

entTfno cliente.0btenerTfno( 
this.DropDownListl.SelectedValue.ToString()); 
imFoto.ImageUrl = entTfno.foto; 

ctNombre.Text = entTfno.nombre; 

ctApellidol.Text = entIfno.apellidol; 

ctApellido2.Text = entIfno.apellido2; 
È 
E 

















tDireccion.Text = entIfno.direccion; 
tTelfono.Text = entIfno.telefonol; 
this.ct0bservaciones.Text = entIfno.observaciones; 








En el código anterior puede ver cómo el método ActualizarCajasDeTexto in- 
voca al método ObtenerTfno pasándole como argumento el teléfono del elemento 
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seleccionado en la lista para obtener los datos correspondientes a esa fila de la ta- 
bla y mostrarlos en las cajas de texto correspondientes. 


Defina como atributos de la clase Default la referencia cliente al servicio 
ServiceClient, necesaria para acceder a la interfaz que ofrece este servicio, y la re- 
ferencia entIfno a una entidad telefonos necesaria para acceder al valor devuelto 
por el método ObtenerTfno: 


RefServiciolfnos.telefono entTfno = null; 
RefServiciolTfnos.ServiceClient cliente = null; 





Mostrar datos 


Cada vez que el usuario seleccione un nuevo elemento de la lista las cajas de texto 
tienen que ser actualizadas con los datos correspondientes al elemento selecciona- 
do. Para ello, interceptaremos el evento SelectedIndexChanged que se genera y 
escribiremos el controlador para este evento como se indica a continuación: 


protected void DropDownListl_SelectedIndexChanged(object sender, 
EventArgs e) 

( 
ActualizarCajasDeTexto(); 

) 


Actualizar datos 


Cuando el usuario desee modificar una determinada fila de la tabla telefonos, 
mostrará esa fila en las cajas de texto seleccionando el elemento correspondiente 
de la lista, hará los cambios deseados y haciendo clic en el botón Actualizar, en- 
viará estos datos al servicio para que los registre en la base de datos. Según lo ex- 
puesto, añada el controlador del evento clic de este botón y complételo así: 


protected void btActualizar_Click(object sender, EventArgs e) 
( 
cliente = new RefServiciolfnos.ServiceClient(); 
entTfno = cliente.ObtenerTfno( 
this.DropDownListl.SelectedValue.ToString()); 
entTfno.nombre = ctNombre.Text:; 
entTfno.apellidol = ctApellidol.Text; 
entTfno.apellido2 = ctApellido2.Text; 
entTfno.direccion = ctDireccion.Text; 
entTfno.telefonol = ctlelfono.Text; 
if (FileUpload1.FileName.Length != 0) 
CambiarFoto(); 
cliente.ActualizarTfnolentTfno); 
Response.AppendHeader("Refresh", "0"); 
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Este método obtiene la entidad entTfno correspondiente al elemento seleccio- 
nado de la lista, modifica los datos de la entidad con los valores correspondientes 
de las cajas de texto y del control FileUpdate (método cambiarFoto) e invoca al 
método ActualizarTfno para enviar la entidad modificada al nivel del servidor y 
actualizar la base de datos. Finalmente, refresca la página para actualizar la lista 
en el caso de que los valores modificados hayan sido el apellido] o el telefono 
vinculados con la misma. 


Cambiar foto 


Cambiar la foto implica tres operaciones: una, actualizar el campo foto de la enti- 
dad actual con el nombre del fichero proporcionado por el FileUpdate; dos, bo- 
rrar la foto actual de la carpeta fotos; y tres, añadir la nueva foto a la carpeta fotos. 


protected void CambiarFoto() 
( 
try 
( 
// Ruta hasta la carpeta del sitio web 
string sRutaSitioWeb = Server.MapPath("/ClienteWCFlinq"); 
// Borramos la imagen actual 
if (entIfno.foto != null) 
File.Delete(sRutaSitioWeb + "/" + entTfno.foto); 
// Subir la foto al servidor 
FileUpload1.PostedFile.SaveAs(sRutaSitioWeb + 
"/fotos/" + FileUpload1.FileName); 
// Cambiar el campo foto de la entidad actual 
entTfno.foto = "fotos/" + FileUpload1.FileName; 





) 
catch (Exception ex) 
( 
etError.Text = ex.Message; 
) 
) 


S1 se produce un error “Acceso denegado a la ruta ...”, seguramente será por- 
que el usuario utilizado por ASP.NET no está autorizado para obtener acceso al 
recurso solicitado: carpeta fotos. La solución fue explicada en el apartado Seguri- 
dad asociada con una carpeta del capítulo ASP.NET. 


Agregar datos 


Para agregar un nuevo objeto telefono (una nueva fila a la tabla telefonos) el usua- 
rio, simplemente, editará cada uno de los campos mostrados por la interfaz gráfica 
y hará clic en el botón Añadir para enviar los cambios a la base de datos. Por lo 
tanto, añada el controlador del evento clic de este botón y complételo así: 
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protected void btAgregar_Click(object sender, EventArgs e) 

( 
cliente = new RefServiciolfnos.ServiceClient(); 
entTfno = new RefServiciolfnos.telefono(); 
entTfno.nombre = ctNombre.Text:; 
entTfno.apellidol = ctApellidol.Text; 
entTfno.apellido2 = ctApellido2.Text; 
entTfno.direccion = ctDireccion.Text; 
entTfno.telefonol = ctlelfono.Text; 
try 
( 














cliente.AgregarTfno(entIfno); 
Response.AppendHeader("Refresh", "0"); 
TA (Exception ex) 
etError.Text = "Error: ¿existe el teléfono?"; 
) 


Este método crea una nueva entidad entTfno correspondiente al elemento se- 
leccionado de la lista, modifica los datos de la entidad con los valores correspon- 
dientes de las cajas de texto e invoca al método AgregarTfno para enviar la 
entidad modificada al nivel del servidor y actualizar la base de datos. La foto se 
puede poner posteriormente haciendo una actualización. Finalmente, refresca la 
página para actualizar la lista. 


Borrar datos 


Para borrar un objeto telefono (una fila de la tabla telefonos) el usuario selecciona- 
rá el elemento correspondiente en la lista desplegable y hará clic en el botón Bo- 
rrar para ejecutar dicha operación sobre la base de datos. Según esto, complete el 
controlador de este botón como se indica a continuación: 


protected void btBorrar_Click(object sender, EventArgs e) 
( 
cliente = new RefServiciolfnos.ServiceClient(); 
entTfno = cliente.ObtenerTfno(l 
this.DropDownListl.SelectedValue.ToString()); 





try 

( 
cliente.BorrarTfno(entTfno); 
BorrarFoto(); 
Response.AppendHeader("Refresh", "0"); 

) 

catch (Exception ex) 

( 


etError.Text = "Error: ¿existe el teléfono?":; 
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Este método obtiene la entidad entTfno correspondiente al elemento seleccio- 
nado de la lista e invoca al método BorrarTfno para enviar la entidad modificada 
al nivel del servidor y borrarla de la base de datos. También borra la foto corres- 
pondiente a esta entidad de la carpeta fotos, para lo cual invoca al método Bo- 
rrarFoto. Finalmente, refresca la página para actualizar la lista. 


protected void BorrarFoto() 
( 
try 
( 
// Ruta hasta la carpeta del sitio web 
string sRutaSitioWeb = Server.MapPath("/ClienteWCFlinq"); 
// Borramos la imagen actual 
if (entIfno.foto != null) 
File.Delete(sRutaSitioWeb + "/" + entTfno.foto); 
) 
catch (Exception ex) 
( 
etError.Text = ex.Message; 
) 
) 


Errores inesperados 


Finalmente, pensando en la concurrencia, puede suceder que un usuario realice 
desde un punto de Internet una modificación, por ejemplo, de un número de telé- 
fono (valor almacenado por la lista y utilizado para acceder a una determinada en- 
tidad), y otro usuario desde otro punto de Internet intente acceder al teléfono que 
ya no existe porque fue modificado sin que él tenga conocimiento de este hecho. 
Al intentar obtener una entidad con un teléfono no existente, se producirá un 
error. Con el fin de atrapar estos errores y permitir al usuario volver a la página 
actualizada (recargada), añada a la clase que define la misma el método indicado a 
continuación: 


protected void Page_Error(object sender, EventArgs e) 
( 


Exception objError = Server.GetLastError().GetBaseException(); 


string mensajeError = "<h3>Error: </h3><hr><br>" + 
objError.Message.ToString() + 
"<br><br><a href="Default.aspx*>Volver</a>"; 
Response.Write(mensajeError.ToString()); 
Server.ClearError(); 
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El cliente está finalizado. Ejecútelo y compruebe los resultados. 


EJERCICIOS PROPUESTOS 


1.  Diseñe una base de datos que permita organizar las citas que los alumnos matricu- 
lados en la universidad conciertan con sus profesores para solucionar dudas sobre 
las materias que estos imparten. Se trata de crear una aplicación distribuida multi- 
capa para Internet. La aplicación constará de tres capas: presentación, lógica de 
negocio y datos. La capa de datos será una base de datos SQL Server. La capa co- 
rrespondiente a la lógica de negocio manejará el acceso a los datos y su distribu- 
ción entre los clientes web. La capa de presentación constará de una aplicación 
Windows y una aplicación web. La siguiente figura describe su arquitectura: 


Cliente Windows 


Formulario 
Windows Servicio web XML 


Métodos para 
Cliente web acceso a datos 


Formulario 
web 





La base de datos estará formada por tres tablas: profesores, tutorias y citas. 
Precisamente será la tabla citas la que almacene los datos sobre la tutoría que un 
alumno solicite a través de un formulario. Supongamos que la base de datos SOL 
Server que deseamos crear la denominamos bd tutorias y que la estructura de es- 
tas tablas es la siguiente: 








rofesores tutorias citas 
p 
Y id_profesor Y id_tutoria Y id_tutoria 
profesor id_profesor alumno 
dia asunto 








hora 
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La lógica de negocio que crearemos se ejecutará en un servidor de aplicacio- 
nes, concretamente en IIS, y se implementará como un servicio web con el fin de 
que los clientes puedan utilizar los protocolos estándar de Internet para comuni- 
carse con esta capa. El servicio web mostrará tres métodos: ObtenerldTutorias, 
ObtenerProfesoresTutorias y GuardarCitas. 


El método ObtenerldTutorias obtendrá de la base de datos bd tutorias solo 
los identificadores de las tutorías que quedan disponibles del total de tutorías re- 
glstradas en la tabla tutorias. Las tutorías que ya han sido solicitadas figuran en la 
tabla citas. A modo de ejemplo, la sentencia SELECT equivalente que proporcio- 
na el resultado requerido sería así: 


SELECT tutorias.id_tutoria 
FROM tutorias 
WHERE (tutorias.id_tutoria NOT IN (SELECT id_tutoria FROM citas)) 


El método ObtenerProfesoresTutorias obtendrá de la base bd" tutorias de datos 
el identificador, el profesor, el día y la hora, de la tutoría entre todas las tutorías 
que aún no hayan sido solicitadas. El nombre del profesor se obtendrá de la tabla 
profesores, y las tutorías no solicitadas serán las que figuran en la tabla tutorias y 
no estén en la tabla citas: 


SELECT tutorias.id_tutoria, profesores.profesor, 
tutorias.dia, tutorias.hora 
FROM profesores INNER JOIN tutorias 
ON profesores.id_profesor = tutorias.id_profesor 
WHERE (tutorias.id_tutoria NOT IN (SELECT 1d_tutoria FROM citas)) 


El método GuardarCitas insertará en la tabla citas de la base de datos 
bd _tutorias los datos id tutoria, alumno y asunto de la tutoría concertada. Estos 
datos habrán sido enviados al servidor a través de los controles ctAlumno, 
IsdldTutoria y ctAsunto del formulario Windows o web. 


INSERT INTO citas(id_tutoria, alumno, asunto) 
VALUES (Oid_tutoria, Calumno, Casunto) 





SELECT ¡id_tutoria, alumno, asunto FROM citas 


Después de crear la lógica de negocio para el acceso a datos y exponerla co- 
mo un servicio web, el siguiente paso es la creación de las interfaces gráficas co- 
rrespondientes a los clientes. Según expusimos al principio de este proyecto, 
existen dos escenarios: un formulario Windows tradicional y una página web im- 
plementada por medio de un formulario web. Ambos se crearán en este ejemplo 
como proyectos independientes en la misma solución. 
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Un formulario Windows utiliza la capacidad del equipo cliente para adminis- 
trar parte del procesamiento de la aplicación. Comparándolo con un formulario 
web, proporciona una mayor funcionalidad y una experiencia más rica para el 
usuario, y carga menos el servidor, ya que este no tiene que realizar toda la lógica 
de la aplicación. Adicionalmente, un formulario Windows puede beneficiarse de 
los recursos disponibles a través del sistema operativo, lo que incluye llamadas al 
sistema de ficheros y al registro de Windows. 


La aplicación Windows presentará un formulario que contendrá una referen- 
cia web al servicio web ServWebTutorias. 


EE] Cliente Windows Tutorías 


CONCERTAR UNA TUTORÍA 


Alumno: [Javier Ceballos Femández 


ID tutoría: |2 y 


1D tutoria Profesor Día 


n Fco. Javier Ceballos Sierra lunes 


Fco. Javier Ceballos Sierra miércoles 
Inmaculada Rodríguez Santiago miércoles 
Inmaculada Rodríguez Santiago jueves 


Concha Batanero Ochaita miércoles 


Programación Avanzada. Tema 3. Constructores. 


Enviar datos | 





Este formulario estará compuesto por los controles siguientes: etiquetas, ctA- 
lumno de la clase TextBox, /sdldTutoria de la clase ComboBox, dgvTutorias de 
la clase DataGridView, ctAsunto de la clase TextBox con su propiedad Multiline 
a true, y btEnviar de la clase Button. Asigne a las propiedades CausesValidation 
y DropDownsStyle de la lista los valores false y DropDownList, respectivamente. 


Una interfaz web permite que la aplicación llegue a una amplia variedad de 
equipos cliente que tengan instalado un explorador (también llamado “navega- 
dor”). En este caso, todo el proceso de la interfaz de usuario se realiza en el servi- 
dor web y no en el cliente. 


La aplicación web presentará un formulario que contendrá una referencia web 
al servicio web ServWebTutorias. Los identificadores de las tutorías que se pue- 
den seleccionar serán mostrados en una lista desplegable y los datos relativos a las 
mismas en una tabla o rejilla, justo cuando se cargue la página web. La tabla no 
permitirá realizar ninguna operación sobre los datos. El formulario tendrá también 
un botón Enviar datos que permitirá guardar en la base de datos los datos relati- 
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vos a la tutoría concertada. La siguiente figura muestra el cliente web que se im- 
plementará: 


EM - Microsoft Internet Explorer 


Archivo Edición Yer Favoritos Herramientas Ayuda T 


Q us - Q [x] a EA JO Búsqueda J Favoritos e B- a wW > m] el 3 


Dirección ES] http: //localhost/FormwWebTutorias/FormwWebTutorias,aspx v| Edr Vinculos 


» 























CONCERTAR UNA TUTORÍA 


Alumno: |Javier Ceballos Fernández 


ID tutoría: |7 w 


ID tutoria Profesor 
2 Fco. Javier Ceballos Sierra lunes 
4 Fco. Javier Ceballos Sierra miércoles 
6 Inmaculada Rodríguez Santiago miércoles 
7 Inmaculada Rodríguez Santiago jueves 
10 Concha Batanero Ochaita miércoles 


Programación Avanzada. Tema 3. Constructores 








“Y Intranet local 


Uno de los servicios que ofrece Internet es el IRC (Internet Relay Chat — charlar 
conectados a través de Internet) conocido normalmente como chat (charlar). A 
través de IRC, se puede charlar con otros usuarios que en ese momento también 
estén conectados a la red, no importa en qué parte del mundo. 


Hay chats de todo tipo, desde el que solo admite texto hasta el que combina 
también voz e imagen junto con la posibilidad de compartir ficheros, dibujar en 
una misma pizarra, o bien chats en 3D acompañados de videoconferencia. 


Vamos a ver un ejemplo relativamente sencillo, donde se pone de manifiesto 
que un servicio web puede manejar múltiples peticiones concurrentes y puede sin- 
cronizarlas, lo que permite soportar sistemas como conferencias múltiples en lí- 
nea. El ejemplo consiste en construir una aplicación que implemente un servicio 
de chat: una serie de usuarios (clientes) se conectan al chat (servidor) de forma 
que cada mensaje transmitido por un usuario le llega a todos los demás. Gráfica- 
mente puede verse así: 


936 ENCICLOPEDIA DE MICROSOFT VISUAL CH 


iniciar.aspx 








conversación MN 







— Usuario 1—> 














Servicio web 
SvMostrarConv 








mensaje 


(enviarMsj.aspx) 














Clase 


iniciar.aspx Conversacion 












Servicio web 


F conversación SvAnyadirMsj 
——Usuario 2—> 











mensaje 


(enviarMsj.aspx) 














Cuando un usuario desee iniciar una conversación, escribirá en su explorador 
un URL de la forma http://servidor/chat/iniciar.aspx. El fichero iniciar.aspx da 
acceso al chat mostrando una ventana similar a la de la figura siguiente. 


3 Chat - Microsoft Internet Explorer 


Archivo Edición Yer Favoritos Herramientas Ayuda 


Q rs - Q E E) % JO Búsqueda J Favoritos Q) Multimedia e B- ps 


Dirección [8] http: /flocalhost:8080/chatfiniciar html vr o víncos 














Fran: Hola Javi. Estaba hablando con Laura de las próximas vacaciones. 
Javi: ¿A dónde vamos a ir este año? 

Fran: Creo que a Granada 

Laura: A mi me gustaría ir a Santander. Me han dicho que es muy bonito. 
Javi: Sí que es un sitio bonito. 

Fran: Pero nosotros ya hemos estado muchas veces. 

Javi: Además, en Granada es más probable que nos haga buen tiempo. 
Laura: Bueno, no me importa. Granada tampoco lo conozco. 

Javi: Yo, donde quiero volver es a Barcelona 

Laura: Y yo también 

Fran: ¿Por qué? 

Javi: Porque la última vez que estuvimos no nos dio tiempo a ver todo. 


[Podemos hacerlo el próximo año. 











«“ Intranet local 


Esta ventana es una página web con dos marcos: uno para mostrar la conver- 
sación y otro para enviar el mensaje. La página que visualiza el marco superior es 
generada dinámicamente por un servicio web, que, según se observa en la figura 
anterior, se denomina SvMostrarConv. Este servicio web tiene como finalidad ac- 
tualizar periódicamente la información mostrada en el marco superior de la página 
web mostrada por el cliente al usuario. Para ello, SvMostrarConv inicialmente ob- 
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tiene la conversación almacenada por la matriz conversación de tipo String de la 
clase Conversacion. Después, genera una página web en la que cada elemento de 
la matriz dará lugar a una línea. Además, especifica en su cabecera que, una vez 
que haya sido presentada, solicite de nuevo su actualización transcurridos 6 se- 
gundos. Para ello, puede utilizar la etiqueta meta de head cuyo formato es: 


<meta http-equiv="refresh" content="número_segundos;url=url_de refresco"> 


El valor http-equiv indica que hay que actualizar la página, content indica el 
número de segundos que deben pasar antes de la actualización y url especifica el 
documento HTML que sustituye al actual. Si se indica cero segundos, la transi- 
ción entre uno y otro documento será inmediata, y si no se indica url, se refrescará 
el documento actual. 


La página que visualiza el marco inferior es generada inicialmente por el fi- 
chero denominado enviarMsj.aspx, según se observa en el fichero inciar.aspx. El 
código correspondiente a esta página muestra un formulario con dos cajas de tex- 
to, una para poner el nombre del usuario y otra para escribir el mensaje, y un bo- 
tón Enviar. 


Cuando se pulsa el botón Enviar, la acción es solicitar al servicio web Sv- 
AnyadirMsj que añada el mensaje a la conversación para que lo vean todos los 
que están participando en la charla. Por lo tanto, la labor de este servicio será ob- 
tener el mensaje enviado y quién lo envió, añadirlo a la matriz conversación de la 
clase Conversacion y responder al cliente devolviéndole de nuevo el formulario 
para que pueda enviar otro mensaje. 


Finalmente, la clase Conversacion proporcionará dos métodos: uno para ob- 
tener los mensajes almacenados en la matriz conversación y otro para añadir el úl- 
timo mensaje recibido. Este mensaje se almacena en la última posición de la 
matriz desplazando todos una posición (el mensaje de la primera posición, el me- 
nos reciente, se elimina). 


Los métodos añadirMensaje y obtenerConversacion de la clase Conversacion 
deberían ser sincronizados. ¿Por qué? Nuestro chat va a ser utilizado por múlti- 
ples usuarios y, por lo tanto, acceder simultáneamente, por ejemplo, al método 
añadirMensaje podría generar problemas (condiciones de carrera) durante la ac- 
tualización de la matriz. 
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SEGURIDAD DE APLICACIONES 
ASP.NET 


La autenticación es el proceso de descubrir y comprobar la identidad de un prin- 
cipal mediante el examen de las credenciales del usuario y la validación de las 
mismas consultando a una autoridad determinada. Y la autorización es el proceso 
de determinar si se permite a un principal acceder a un recurso específico. La au- 
torización tiene lugar después de la autenticación y utiliza información relativa a 
la identidad y funciones del principal para determinar a qué recursos puede tener 
acceso dicho principal. 


Pero ¿qué es un principal? Un principal es un objeto que representa la identi- 
dad y la función de un usuario y actúa en su nombre. La seguridad basada en fun- 
ciones de .NET Framework admite tres tipos de principales: de Windows, genéri- 
cos y personalizados. Los principales de Windows representan a usuarios de Win- 
dows y sus funciones. Los genéricos representan a usuarios y funciones indepen- 
dientes de los usuarios y funciones de Windows. Y los personalizados pueden ser 
definidos por una aplicación en particular. 


ASP.NET puede ser utilizado junto con IIS (Internet Information Services) 
para autenticar los usuarios web con credenciales Windows. El motor ASP.NET 
puede también configurarse para usuarios web que no tengan necesidad de identi- 
ficarse (eliminación de la necesidad de que el proveedor lleve a cabo comproba- 
ciones de identidad del cliente y de acceso para las operaciones solicitadas), o uti- 
lizar su propia identidad Windows para acceder a recursos como bases de datos o 
ficheros. A continuación veremos diferentes formas de identificación de usuarios 
para controlar el acceso a aplicaciones ASP.NET. También comentaremos cómo 
podemos controlar las acciones que el usuario puede realizar en el servidor. 
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Resumiendo, ASP.NET junto con Microsoft .NET Framework e IIS colabo- 
ran para proporcionar aplicaciones web seguras. Para ello, se deben llevar a cabo 
para cada aplicación web las dos funciones principales mencionadas anteriormen- 
te: la autenticación y la autorización. 


ARQUITECTURA ASP.NET 


La figura siguiente muestra una descripción general sobre las relaciones entre los 
subsistemas y la infraestructura de ASP.NET, con respecto a la seguridad. 






































Clientes web 
À 
y 
Aplicaciones ASP.NET << w IIS 
Á À 
y 
.NET Framework 
Á 
y y 
Sistema operativo Windows 











Obsérvese que todos los clientes web se comunican con las aplicaciones 
ASP.NET a través del servidor de aplicaciones IIS, el cual descifra y, opcional- 
mente, realiza la autenticación de la solicitud. Si la opción Autenticación anónima 
(a continuación hablaremos de esto) está establecida a true, no se efectuará nin- 
guna autenticación. A continuación, IIS busca el recurso solicitado (como una 
aplicación ASP.NET) y, si se autoriza al cliente, devolverá el recurso correspon- 
diente. 


Mientras que IIS proporciona distintas clases de autenticación para comprobar 
la identidad del usuario: anónima, básica, de texto implícita, autenticación de 
Windows, autenticación mediante formularios, suplantación de ASP.NET y auten- 
ticación basada en certificados de cliente, ASP.NET implementa el proceso de au- 
tenticación a través de los proveedores de autenticación de Windows y mediante 
formularios (un proveedor de autenticación es un módulo de código; por ejemplo, 
WindowsAuthenticationModule o FormsAuthenticationModule). 


El proveedor de autenticación de Windows define cómo utilizar la autentica- 
ción de Windows junto con la autenticación de IIS y el proveedor de autentica- 
ción mediante formularios permite utilizar un formulario de inicio de sesión para 
autenticar a los usuarios. El mecanismo de autenticación predeterminado para las 
aplicaciones ASP.NET es la autenticación de Windows, mediante el cual se dele- 


CAPÍTULO 18: SEGURIDAD DE APLICACIONES ASP.NET 941 


ga en el sistema operativo la tarea de autenticación de usuarios. Esto es, IIS pro- 
porciona la identidad del usuario al proveedor de autenticación de Windows para 
que este lo trate como el usuario autenticado para la aplicación ASP.NET cuya 
ejecución se solicitó. 


Los dos escenarios más comunes de autenticación son la autenticación de 
Windows para un sitio de intranet local o la autenticación mediante formularios 
para un sitio de Internet. 


Antes de entrar en los detalles relativos a la autenticación y a la autorización, 
echemos un vistazo al ciclo de vida de una aplicación ASP.NET para ver en qué 
instante estos procesos se ejecutan y veamos también cómo afecta a la seguridad 
los grupos de aplicaciones en IIS. 


CICLO DE VIDA DE UNA APLICACIÓN ASP.NET 


El usuario solicita ejecutar una aplicación ASP.NET alojada en un servidor web, 
normalmente es IIS. 


Cuando ASP.NET recibe la primera solicitud para cualquier recurso de una 
aplicación, una clase denominada Application Manager crea un dominio de apli- 
cación, aislando esta aplicación de otras que se puedan estar ejecutando, dentro 
del cual se crea un objeto HostingEnvironment que proporciona acceso a la in- 
formación sobre la aplicación. 

ag” 


i 


Internet 


| 


IIS (u otro servidor web) 


Proceso que ejecuta 
ASP.NET 


ApplicationManager 


| 


Dominio de aplicación 








HostingEnvironment 


A continuación el proceso que ejecuta ASP.NET crea e inicia el objeto 
HttpContext que contiene los objetos HttpRequest y HttpResponse. El objeto 
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HttpRequest contiene datos sobre la solicitud actual y el objeto HttpResponse 
contiene la respuesta que se envía al cliente. 


Después, se asigna un objeto HttpApplication a la solicitud. Recuerde que 


Global.asax se analiza y se compila en una clase de .NET Framework generada 
dinámicamente que se deriva de la clase base HttpApplication. 


a” '- i 


[o la E 
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IIS (u otro servidor web) 





ASP.NET i 
ASP.NET ISAPI 
Dominio de aplicación ] 





r 
HttpRuntime 














La canalización de HttpApplication procesa la solicitud. Los mecanismos de 
autenticación y autorización de ASP.NET se implementan mediante módulos 
HTTP (por ejemplo WindowsAuthenticationModule o FileAuthorizationModule), 
que se invocan como parte del procesamiento mediante la canalización de 
ASP.NET estándar: HttpRuntime < > HttpApplication < > Proveedores de Au- 
tenticación < > PageHandler. 


GRUPOS DE APLICACIONES EN IIS 


La seguridad de las aplicaciones web puede ser reforzada utilizando grupos de 
aplicaciones. Un grupo de aplicaciones agrupa sitios y aplicaciones para solucio- 
nar problemas de fiabilidad, disponibilidad y seguridad. ¿Cómo? Estableciendo 
límites para que las aplicaciones que contiene no interfieran ni sean interferidas 
por las aplicaciones de otros grupos. 
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Una aplicación pertenecerá a un grupo porque deseamos que se ejecute con 
una configuración única, porque queremos que se ejecute con la misma configu- 
ración que las otras que ya pertenecen al grupo, para aumentar la seguridad utili- 
zando una determinada identidad al ejecutar una aplicación, para evitar que los re- 
cursos de una aplicación tengan acceso a los recursos de otra aplicación o bien pa- 
ra mejorar el rendimiento separando las aplicaciones inestables de las aplicaciones 
que funcionan correctamente. 





F Administracion de equipos la): ¡ca 
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Un grupo de aplicaciones tiene un nombre descriptivo que lo identifica, espe- 
cifica la versión de .NET Framework bajo la cual se ejecutan las aplicaciones que 
pertenecen al mismo y también especifica el modo de canalización de procesa- 
miento utilizado, la identidad bajo la cual se ejecutan las aplicaciones y el número 
de aplicaciones que pertenecen al grupo. 


Los grupos de aplicaciones se ejecutan en uno de los dos modos siguientes: el 
integrado o el clásico. En el modo integrado, el servidor procesará la solicitud uti- 
lizando las canalizaciones integradas de procesamiento de solicitudes de IIS y 
ASP.NET y en el modo clásico, el servidor procesará la solicitud utilizando de 
manera independiente los modos de procesamiento de solicitudes de IIS y 
ASP.NET, permitiendo así la compatibilidad con versiones anteriores a IIS 7. 


La identidad de un grupo de aplicaciones es el nombre de la cuenta de servi- 
cio con la que se ejecuta el proceso de trabajo de dicho grupo. De manera prede- 
terminada, los grupos de aplicaciones funcionan con la cuenta de usuario Servicio 
de red (NetworkService), que tiene derechos de usuario de bajo nivel, pero pueden 


configurarse para que se ejecuten con una de las cuentas de usuario integradas en 
el sistema operativo Windows. 


AUTENTICACIÓN DE WINDOWS 


Para controlar el acceso a una aplicación web, lo primero es identificar de alguna 
forma al usuario que intenta acceder a la misma. Por regla general, la identifica- 
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ción de un usuario se hace solicitándole su nombre de usuario, que es único, y su 
contraseña (clave secreta del usuario). Ahora bien, de forma predeterminada IIS 
tiene activado el acceso anónimo, lo que significa que el usuario no requiere cre- 
denciales de usuario autenticado para tener acceso al sitio; esto es, la finalidad del 
acceso anónimo es conceder acceso público a una clase de información que no re- 
quiere seguridad. 


Vamos a realizar un ejemplo en el que crearemos una aplicación web 
ASP.NET simple, asegurada con autenticación Windows. 


Inicie Visual Studio y cree un nuevo sitio web vacío de ASP.NET ubicado en 
HTTP, de nombre WebSitel, utilizando Visual Cf, Después, añada al sitio un 
formulario web. 


Arrastre sobre la página web dos controles de tipo Label y denomínelos 
etUsuarioAut y etUsuarioASP. 


A continuación, haga doble clic sobre la página y complete el método Pa- 
ge Load, que responderá al evento Load, como se indica a continuación: 


using System.Security.Principal; // para WindowsIdentity 


public partial class _Default : System.Web.UlI.Page 
( 
protected void Page_lLoad(object sender, EventArgs e) 
( 
string UsuarioAutenticado; 
string UsuarioASP; 
// Usuario que realiza la solicitud de la página 
UsuarioAutenticado = Page.User.Identity.Name; 
UsuarioASP = WindowsIdentity.GetCurrent().Name; 
etUsuarioAut.Text = "Usted es el usuario: " + 
UsuarioAutenticado; 
// Contexto de seguridad bajo el que se ejecuta la página 
etUsuarioASP.Text = 
"La página se ejecuta bajo el contexto de seguridad: " + 
UsuarioASP; 











Un objeto Page representa una página aspx, conocida también como formula- 
rio web o simplemente página web. Para obtener información sobre el usuario que 
realiza la solicitud de la página, Page proporciona la propiedad User. Esta pro- 
piedad devuelve un objeto IPrincipal que representa el contexto de seguridad del 
usuario para el que se está ejecutando el código. Dicho objeto encapsula una refe- 
rencia a un objeto Identity, a través del cual podemos descubrir la identidad del 
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usuario, así como un método para determinar si el usuario es miembro de una fun- 
ción dada. La propiedad User de Page utiliza la propiedad User del objeto 
HttpContext para determinar dónde se origina la solicitud, por lo tanto, la identi- 
dad del usuario que originó la solicitud también podría obtenerse así: 


UsuarioAutenticado = HttpContext.Current.User.Identity.Name; 


Quizás resulte aclaratoria la comparación de “objetos de identidad y principa- 
les” con conceptos conocidos, como las “cuentas de grupo y de usuario”. En un 
entorno de red, generalmente, las cuentas de usuario representan a personas o 
programas, mientras que las cuentas de grupo representan a ciertas categorías de 
usuarios y los derechos que poseen. Análogamente, los objetos de identidad de 
.NET Framework representan a usuarios, mientras que las funciones representan 
pertenencias y contextos de seguridad. Un objeto principal encapsula un objeto de 
identidad y una función, y una aplicación .NET concede derechos al principal ba- 
sándose en su identidad o, lo que es más normal, en su pertenencia a una función. 
La seguridad basada en funciones es útil cuando una aplicación requiere varias 
aprobaciones para completar una acción. Un caso podría ser un sistema de com- 
pras en el que un empleado puede generar una solicitud de compra, pero solo un 
agente de compras puede convertir la solicitud en la orden de compra que debe ser 
enviada al proveedor. Está claro que la función del empleado (el papel desempe- 
ñado por el empleado) tiene un límite inferior a la del agente. 


Un objeto WindowsIdentity del espacio de nombres System.Security.Prin- 
cipal representa a un usuario de Windows. Pues bien, el proveedor de autentica- 
ción basándose en las credenciales proporcionadas por IIS construye una identi- 
dad WindowsIdentity y la establece como el valor actual de la propiedad User, y, 
por otra parte, tenemos la identidad de Windows proporcionada al sistema opera- 
tivo bajo cuyo contexto de seguridad se ejecuta la página (véase el apartado Gru- 
po de aplicaciones en IIS expuesto anteriormente) y que se utiliza para comprobar 
los permisos, como los permisos de ficheros NTFS, o para conectarse a una base 
de datos mediante la seguridad integrada. Para acceder a las credenciales de esta 
identidad hay que llamar al método GetCurrent de WindowsIdentity (se trata de 
un método static). 


La autenticación de Windows es el mecanismo de autenticación predetermi- 
nado para las aplicaciones ASP.NET y se identifica en el fichero de configuración 
Web.config mediante el elemento de configuración authentication asi: 


<authentication mode="Windows"/> 


Eche ahora una ojeada al fichero de configuración Web.config de la aplica- 
ción; si no está, añádalo (explorador de soluciones > clic con el botón secundario 
del ratón sobre el nombre del proyecto > agregar nuevo elemento > archivo de 


946 ENCICLOPEDIA DE MICROSOFT VISUAL C# 


configuración web). Si no localiza la línea anterior, simplemente es porque, como 
hemos dicho, por omisión se supone ese modo de autenticación. 


Compile y ejecute la aplicación. Observará que la página web muestra: 
Usted es el usuario: 


La página se ejecuta bajo el contexto de seguridad: dominio|servidorYusuario 


¿Cómo se traduce la información mostrada? El usuario que realizó la solicitud 
de la página es anónimo y la página se ejecuta bajo el contexto de seguridad de un 
usuario predeterminado, generalmente Servicio de red en Windows Vista o Win- 
dows 7 o superior (ASPNET en Windows XP). Esto es así porque el modo de au- 
tenticación de Windows, por una parte hace que se asigne a la propiedad User de 
la página el objeto WindowsIdentity creado a partir de las credenciales propor- 
cionadas por IIS, según dijimos anteriormente, y por otra, no modifica la identi- 
dad de Windows proporcionada al sistema operativo bajo cuyo contexto se ejecu- 
ta la página, que de forma predeterminada es la identidad correspondiente a la 
cuenta del usuario Servicio de red de Windows. 


Lo anterior indica que si una página aspx tiene que acceder a un recurso con- 
creto, hay que dar al usuario Servicio de red los permisos adecuados. Por ejemplo, 
si la aplicación web tiene que escribir datos en una base de datos, el usuario Ser- 
vicio de red ha de tener los permisos que se lo permitan. 


Este modelo de seguridad es sencillo y simplifica el trabajo del administrador 
del sistema, ya que solo tiene que incluir al usuario Servicio de red en las listas de 
control de acceso a los recursos a los que las aplicaciones web deban tener acceso, 
independientemente de los usuarios que luego accedan a esas aplicaciones. De es- 
ta forma, el administrador no tendrá que ir asignando permisos a cada uno de esos 
usuarios. Además, este modelo favorece la eficiencia de las aplicaciones web; por 
ejemplo, si una aplicación web tiene que interactuar con una base de datos, todas 
las conexiones serán realizadas por el mismo usuario, lo que permite emplear un 
servicio de conexiones (también conocido como “pool de conexiones”) para favo- 
recer la escalabilidad. 


ASP.NET ofrece también la alternativa de utilizar el sistema operativo Win- 
dows como mecanismo de autenticación. Esto significa que el usuario y la con- 
traseña para acceder a la aplicación web serán el usuario y la contraseña emplea- 
dos para acceder a nuestro sistema Windows. Pero esto requiere deshabilitar el 
acceso anónimo para el sitio web, además de especificar Windows como modo de 
autenticación en el fichero Web.config. 
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Continuando con la aplicación, edite el fichero de configuración Web.config y 
localice/edite el elemento <authentication> que tiene la sintaxis siguiente: 


<configuration> 
<system.web> 
<authentication mode="Windows|Forms|Passport|None"> 
<forms name="name" 
¡CANA mmr] 
protection="A11|None|Encryption|Validation" 
timeOWuuL="S0" pawn y > 
requiressiiS"true | false" 
slidingExpiration="true|false"> 
<credentials passwordFormat="Clear|SHA1|MD5"> 
<user name="username" password="password"/> 
</credentials> 
</forms> 











<passport redirecturl="internal"/> 
</authentication> 


<authorization» 


</authorization> 
</system.web> 
</configuration> 


La sección de autenticación, delimitada por la etiqueta <authentication>, se 
utiliza para establecer la política de identificación de usuarios que usará nuestra 
aplicación. ASP.NET permite emplear distintos modos de autenticación, entre los 
que se encuentran los siguientes: 


e Windows. La autenticación utilizada por ASP.NET es la utilizada por Win- 
dows. Utilice este modo con cualquier forma de autenticación de IIS: básica, 
implicita, integrada de Windows o certificados. Con este modo lo que se hace 
es delegar en el sistema operativo la tarea de autenticación de usuarios, con lo 
cual solo podrán acceder a una aplicación ASP.NET aquellos usuarios que 
existan previamente en el sistema donde está instalada. 


e Forms. La autenticación utilizada por ASP.NET emplea un formulario para so- 
licitar el nombre y la contraseña del usuario que quiere acceder a la aplicación 
web. En este caso, seremos nosotros los que decidamos quién accede a nuestra 
aplicación. 


e Passport. La autenticación utilizada por ASP.NET utiliza el sistema de auten- 
ticación Passport de Microsoft (autenticación de pasaporte). 
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e None. ASP.NET no especifica ninguna autenticación. Sólo se esperan usuarios 
anónimos, o bien las aplicaciones pueden controlar los eventos para propor- 
cionar su propia autenticación. 


El elemento <authentication> solo puede declararse en el nivel del equipo, si- 
tio o aplicación. Cualquier intento de declararlo en un fichero de configuración en 
el nivel de subdirectorio dará lugar a un error. 


Deshabilitemos ahora el acceso anónimo. Para ello, es necesario configurar 
IIS para requerir otro tipo de autenticación, por ejemplo, autenticación de Win- 
dows para el sitio WebSitel. Para ello, utilizando el botón secundario del ratón, 
haga clic en Equipo y seleccione Administrar. 


En Windows Vista, 7 o superior se le mostrará la ventana que puede observar 
en la figura siguiente: 
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Haga clic sobre el sitio web WebSite] y después doble clic en el icono Auten- 


ticación de IIS. En la ventana que se muestra, 
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utilizando el botón secundario del ratón, haga clic en Autenticación de Windows y 
habilite este modo de autenticación. Después, de forma análoga, deshabilite la 4u- 
tenticación anónima. Estos cambios se reflejarán en el fichero Web.config (si no 
se reflejan es porque la autenticación de Windows es el mecanismo de autentica- 
ción predeterminado para las aplicaciones ASP.NET). 


Nota: la autenticación de Windows solo está soportada en una intranet, no en 
Internet. Para acceder a Internet habría que utilizar autenticación básica. 


Vuelva a ejecutar de nuevo la aplicación web. Le será solicitado su nombre de 
usuario y contraseña y observará que ahora la página web muestra: 


Usted es el usuario: dominto|servidorYsu nombre de usuario 


La página se ejecuta bajo el contexto de seguridad: 
dominto|servidorYusuario ASP.NET 


El usuario ahora es el usuario autenticado en el sistema operativo de Windows, 
esto es, la autenticación utilizada por ASP.NET es la utilizada por Windows, y la 
página aspx se ejecuta bajo el contexto de seguridad del usuario de ASP.NET 
(Servicio de red). 


Nota: cuando junto con la autenticación de ASP.NET se utiliza la autentica- 
ción básica de IIS, el nombre de usuario y contraseña se transmiten del explora- 
dor al servidor web sin cifrar, lo cual supone que terceros malintencionados pue- 
den interceptar esta información. Este inconveniente puede salvarse habilitando 
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las características de cifrado de SSL (Secure Sockets Layer) del servidor web. No 
obstante, para habilitar SSL, antes debe instalar un certificado de servidor. 


AUTORIZACIÓN 


La autorización controla el acceso del cliente a los recursos de direcciones URL. 
Edite el fichero Web.config y localice/edite el elemento <authorization> que tiene 
la sintaxis siguiente: 


<configuration> 
<system.web> 
<authentication mode="Windows"/> 
<authorization> 
<allow users="/i1sta de usuarios separados por comas" 
roles="/ista de funciones separadas por comas" 
verbs="Jista de verbos separados por comas"/> 
<deny users="Jista de usuarios separados por comas" 
roles="]ista de funciones separadas por comas" 
verbs="Jista de verbos separados por comas"/> 
</authorization> 
</system.web> 
</configuration> 





La etiqueta <allow> permite el acceso a un recurso y <deny> lo deniega. 
Ambas tienen las siguientes opciones: 


e users: lista de nombres de usuario con acceso (allow) al recurso, o lista de 
nombres de usuario a los que se les deniega (deny) el recurso, separados por 
comas. El signo de interrogación (?) indica que se admite/deniega a los usua- 
rios no autenticados (un usuario anónimo es un usuario no autenticado), y el 
asterisco (*), que se admite/deniega a todos los usuarios autenticados. 


e roles: lista separada por comas que indica las funciones a las que se conce- 
de/deniega acceso al recurso. 


e verbs: lista separada por comas que indica los métodos de transmisión HTTP a 
los que se concede/deniega acceso al recurso. Los verbos registrados en 
ASP.NET son GET, HEAD, POST y DEBUG. 


El elemento <authorization> puede declararse en cualquier nivel: equipo, si- 
tio, aplicación, subdirectorio o página. Esto es, en los subdirectorios se pueden in- 
cluir otros ficheros Web.config que redefinan las restricciones de acceso a los re- 
cursos de nuestra aplicación web de esos subdirectorios. De esta forma, permitir, 
por ejemplo, que usuarios nuevos se registren en nuestra aplicación web es una ta- 
rea fácil; de otra forma, sería necesaria una aplicación web independiente. 
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Por ejemplo, si queremos que cualquier usuario pueda acceder a una parte de 
nuestra aplicación, incluso sin identificarse, basta con incluir la siguiente autori- 
zación en el fichero de configuración Web.config en la carpeta adecuada: 


<authorization> 
<allow users="*" /> 
</authorization> 


Esto nos permite desarrollar aplicaciones en las que haya partes públicas y 
partes privadas, como sucede con cualquier aplicación de comercio electrónico. 
En ellas, los usuarios pueden navegar libremente por el catálogo de productos pe- 
ro han de identificarse al efectuar sus compras. 


Si lo que queremos es restringir el acceso a grupos de usuarios particulares, 
incluiríamos una sección de autorización análoga a la siguiente: 


<authorization> 
<allow users="dominiolAdministradores" /> 
<deny users="x*" /> 

</authorization»> 


Este ejemplo permite el acceso a todos los usuarios de la función Administra- 
dores del dominio especificado y se lo deniega a todos los demás. 


Si lo que queremos es restringir el acceso a ciertos usuarios, incluiríamos una 
sección de autorización análoga a la siguiente: 


<authorization> 
<allow users="dominiolusuariol, dominiolusuario2" /> 
<deny users="*" /> 

</authorization> 


Este otro ejemplo permite el acceso a los usuarios especificados y se lo denie- 
ga a todos los demás. 


Si lo que queremos es restringir el acceso a ciertos usuarios en función del 
método de transmisión empleado, incluiríamos una sección de autorización análo- 
ga a la siguiente: 


<authorization> 
<allow verb="P0ST" users="Francisco" /> 
<deny verb="P0OST" users="*" /> 
<allow verb="GET" users="*" /> 
</authorization> 
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Este ejemplo permite el acceso al usuario Francisco utilizando el método de 
transmisión POST y se lo deniega a todos los demás que utilicen este método de 
transmisión. También permite el acceso a todos los usuarios utilizando el método 
de transmisión GET. 


Cuando se definen varias reglas, se aplicarán en el orden en el que aparecen. 
Se aplicará la primera regla que coincida. 


SUPLANTACIÓN DE IDENTIDAD 


La suplantación de identidad de forma predeterminada está deshabilitada. Cuando 
se utiliza, las aplicaciones ASP.NET se pueden ejecutar con la identidad de Win- 
dows (cuenta de usuario) del usuario que realiza la solicitud. De esta forma se evi- 
tan problemas de autenticación y autorización en el código de la aplicación 
ASP.NET. En este caso y según muestra la figura siguiente, IIS realiza la autenti- 
cación del usuario y pasa un símbolo “autenticado” a la aplicación ASP.NET o 
bien, si no puede autenticar al usuario, le deniega el acceso. Si la autenticación re- 
sulta satisfactoria y la suplantación está habilitada, el proceso de ASP.NET su- 
plantará al usuario que realiza la solicitud utilizando sus credenciales para acceder 
a los recursos en su nombre, y en el caso de que la suplantación no esté habilitada 
lo hará bajo el contexto de seguridad del usuario Servicio de red. 
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Nota: este tipo de configuración de ASP.NET no se aplica en el modo inte- 
grado de canalización administrada, utilice el modo clásico. 


Según la figura anterior, un cliente de la red hace una petición que implica la 
ejecución de una aplicación ASP.NET desplegada en el servidor de aplicaciones 
IIS. Entonces: 


1. IIS recibe la solicitud y autentica al cliente utilizando la autenticación básica 
implicita o la autenticación de Windows. 


2. Si la autenticación se realiza con éxito, IIS pasará la solicitud autenticada a 
ASP.NET. 


3. Si la suplantación no está habilitada, la aplicación se ejecutará con la identi- 
dad predeterminada: cuenta Servicio de red en Windows Vista o 7, o cuenta 
ASPNET en Windows XP. 


4. Si la suplantación está habilitada (impersonate = “true”, la aplicación se eje- 
cutará con la identidad del usuario de Windows autenticado. 


5. Finalmente, si se concede el acceso, la aplicación ASP.NET devolverá la pá- 
gina solicitada a través de IIS. 


Según lo expuesto hasta ahora, cuando no está habilitada la suplantación, la 
aplicación se ejecuta con la identidad del usuario Servicio de red o ASPNET. 
¿Cómo se configura la aplicación ASP.NET para que se ejecute con la identidad 
del cliente? Para hacerlo, edite el fichero Web.config y añada la siguiente línea 
después del elemento authentication: 


<identity impersonate = "true" /> 


Ejecute la aplicación y observe que ahora la página web visualiza: 
Usted es el usuario: dominto|servidorYsu nombre de usuario 


La página se ejecuta bajo el contexto de seguridad: 
dominto|servidorYsu nombre de usuario 


AUTENTICACIÓN MEDIANTE FORMULARIOS 


El modo de autenticación Windows utilizado con cualquier forma de autentica- 
ción de IIS exige que el usuario que accede a la aplicación ASP.NET esté dado de 
alta en el sistema operativo. Pero, en ocasiones, nos interesará que sea la propia 
aplicación la que gestione y controle el acceso de los usuarios a la misma, recopi- 
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lando sus credenciales en el inicio de sesión a través de formularios HTML, en 
vez de tener que darlos de alta en el sistema operativo. ASP.NET implementa este 
proceso a través de la autenticación mediante formularios. 


Y 





En este escenario, la aplicación utiliza un proceso implementado por el desa- 
rrollador basado en formularios que permite recopilar las credenciales, como el 
nombre y la contraseña, directamente del cliente solicitante, así como determinar 
su autenticidad y, a continuación, conserva un identificador de autenticación en 
una cookie o en la dirección URL de la página. La autenticación de IIS no se utili- 
za en la aplicación, pero las configuraciones de autenticación de IIS son importan- 
tes para el proceso de autenticación mediante formularios ASP.NET. Esto es, si 
no habilita la configuración Autenticación anónima de IIS, las solicitudes que no 
cumplan los criterios de autenticación de IIS serán rechazadas y no tendrán acceso 
a la aplicación ASP.NET. 


Según la figura anterior, un cliente de la red hace una petición que implica la 
ejecución de una aplicación ASP.NET desplegada en el servidor de aplicaciones 
IIS. Entonces: 


1. IIS recibe la solicitud y si autentica al solicitante, o si está habilitada la 4uten- 
ticación anónima de IIS, la solicitud se pasa a la aplicación ASP.NET. 
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2. Como en este caso la aplicación ASP.NET implementa el modo de autentica- 
ción mediante formularios, no se utilizará la autenticación de Windows prede- 
terminada. 


3. Si no hay ninguna cookie asociada a la solicitud, ASP.NET redirige la solici- 
tud a la página de inicio de sesión, cuya ruta de acceso reside en el fichero 
Web.config de configuración de la aplicación, tal como se indica a continua- 
ción: 


<!-- Fichero Web.config --> 
<authentication mode="Forms"> 
<forms name=".ASPXFORMSAUTH" loginUrl="login.aspx"> 
</forms> 
</authentication> 
<authorization» 
<deny users="?" /> 
</authorization> 











El atributo name especifica el nombre de la cookie HTTP utilizada para la au- 
tenticación. De forma predeterminada, el nombre de la cookie que contiene las 
credenciales del usuario utilizadas para la autenticación es .ASPXFORMS- 
AUTH. Si se ejecutan varias aplicaciones en un mismo servidor y cada una 
requiere una cookie única, debe configurar el nombre de la misma en el fiche- 
ro Web.config de cada aplicación. 


El atributo loginUrl especifica la dirección URL a la que debe redirigirse la 
solicitud de inicio de sesión si no se encuentra ninguna cookie de autentica- 
ción válida. El valor predeterminado es login.aspx. 


Si fuera preciso configurar dentro de <forms> un almacén de credenciales, 
podría hacerse a través de la etiqueta <credentials>. Por ejemplo: 


<credentials passwordFormat="Clear"> 
<user name="usuariol" password="contraseñal"/> 
<user name="usuario2" password="contraseña2"/> 
</credentials> 


En este caso, las credenciales proporcionadas se validarían, comparándolas 
con las contenidas en el almacén de credenciales configurado, así: 


if (FormsAuthentication.Authenticate(l 
ctUsuario.Text, ctContraseña.Text)) 
( 
// Retornar a la petición (URL) inicial 
FormsAuthentication.RedirectFromLoginPage(l 
ctUsuario.Text, cvRecordarContraseña.Checked):; 
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else 
etError.Text = "Error: Las credenciales no son válidas. 
"Inténtelo otra vez."; 


"+ 


4. En la página de inicio de sesión (login.aspx), el usuario (cliente) escribe las 
credenciales requeridas (por lo general, el nombre y la contraseña). 


5. El código de la aplicación comprueba las credenciales para confirmar su au- 
tenticidad, normalmente, en un controlador de eventos. Si se autentican las 
credenciales, la aplicación crea una cookie que incluye el nombre de usuario, 
pero no la contraseña. Si la autenticación falla, la solicitud se devuelve nor- 
malmente con el mensaje “Acceso denegado” o se vuelve a presentar el for- 
mulario de inicio de sesión. 


6. Si se autentica al usuario, ASP.NET comprueba la autorización. Si se autoriza 
al usuario, ASP.NET puede permitir el acceso al recurso protegido que se ha 
solicitado en un principio o redirigir la solicitud a otra página, dependiendo 
del diseño de la aplicación. También puede dirigir la solicitud a un módulo de 
autorización personalizado donde se prueban las credenciales para autorizar el 
acceso al recurso protegido. Si la autorización falla, ASP.NET siempre rediri- 
ge a la página de inicio de sesión. 


Como ejemplo, vamos a crear un nuevo sitio web vacío ubicado en HTTP, de 
nombre AutForms, utilizando Visual C#. Después, añada al sitio un formulario 
web, diséñelo igual que lo hizo en WebSitel, y configure el sitio tal como se indi- 
có en el punto 3. Para centrarnos en el tema de autenticación mediante formula- 
rios, dejamos a criterio del lector implementar la validación de los datos introdu- 
cidos por el usuario, por ejemplo, mediante controles de validación según se ex- 
plicó en el capítulo Formularios web. 


Una vez configurada la aplicación, se debe proporcionar una página de inicio 
de sesión. La vamos a denominar login.aspx y mostrará una interfaz similar a la 
indicada en la figura siguiente. Para ello, haga clic con el botón secundario del ra- 
tón sobre el nombre del proyecto en el explorador de soluciones y seleccione 
Agregar nuevo elemento > Formularios Web Forms. Complete el formulario con 
dos etiquetas (etUsuario y etContraseña), dos cajas de texto (ctUsuario y ctCon- 
traseña), una casilla de verificación (cvRecordarContraseña), un botón btEnviar 
y una etiqueta para mostrar el mensaje “Acceso denegado” cuando sea preciso. 
Asigne a la propiedad TextMode de ctContraseña el valor Password. El resultado 
será similar al siguiente: 
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login.aspx.cs CUE Default. aspx.cs Default.aspx 
[body | 


Usuario: 
Contraseña: 


M Recordar contraseña 


Enviar 


Error: 


Una vez concluido el diseño del formulario, complete el controlador del even- 


to Load de la página login.aspx y el controlador del evento Click del botón En- 
viar, según se indica a continuación: 


protected void Page_load(object sender, EventArgs e) 
( 
etError.Text = ""; 


) 


protected void btEnviar_Click(object sender, EventArgs e) 
( 





// Obtener las credenciales para realizar la autenticación 
string usuario = "usuariol"; 

string contraseña = "contraseñal"; 

if (Page.IsValid) 


if (ctUsuario.Text.Equals(usuario) 88 
ctContraseña.Text.Equalsícontraseña)) 
// Retornar a la petición (URL) inicial 
FormsAuthentication.RedirectFromLoginPage(l 
ctUsuario.Text, cvRecordarClontraseña.Checked); 





else 
etError.Text = "Acceso denegado”; 


Ahora, cuando se ejecute la aplicación AutForms, se solicitará la página De- 
fault.aspx. Asegúrese de que está habilitada la configuración Acceso anónimo de 
IIS para el sitio AutForms. Las solicitudes no autenticadas se desviarán a la pági- 
na de inicio de sesión (/ogin.aspx), la cual presenta un formulario que, según ve- 
mos en la figura anterior, pide un nombre de usuario y una contraseña (para este 
ejemplo utilice como credenciales “usuario1” y “contraseñal”). 


Después de validar las credenciales, la aplicación realizará la siguiente llama- 
da: 
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FormsAuthentication.RedirectFromLoginPagel 
ctUsuario.Text, cvRecordarContraseña.Checked); 


De esta forma, se vuelve a dirigir al usuario hacia la dirección URL original 
solicitada. El método RedirectFromLoginPage pertenece a la clase Forms- 
Authentication del espacio de nombres System.Web.Security. El primer pará- 
metro especifica el nombre del usuario a efectos de la autorización de la dirección 
URL, y el segundo parámetro especifica si se debe generar o no una cookie utili- 
zada para la autenticación. 


Si el usuario no se identifica correctamente, porque no esté dado de alta o 
porque no haya introducido correctamente su nombre de usuario o contraseña, se 
mostrará un mensaje informativo de error; en el ejemplo “Acceso denegado”. 


En una aplicación real, los nombres de usuario y las contraseñas correspon- 
dientes estarán almacenados en una base de datos. También, cuando un usuario no 
se autentica porque no existe en la base de datos, podríamos redirigirlo a otra pá- 
gina mediante Response.Redirect("http://..."). Esto último suele ser lo más ade- 
cuado si nuestro sistema permite que nuevos usuarios se den de alta ellos mismos. 


CONTROLES PARA INICIO DE SESIÓN 


ASP.NET provee varios controles para implementar la funcionalidad de inicio de 
sesión (autenticación) para las aplicaciones web sin necesidad de programación, 
tales como Login, LoginView o LoginStatus, entre otros, controles que podemos 
utilizar para crear nuestras propias páginas de inicio de sesión. En un capítulo 
posterior veremos que Visual Studio también proporciona plantillas para aplica- 
ciones y sitios web que ya incluyen páginas que permiten que los usuarios se re- 
gistren en una nueva cuenta, inicien una sesión y cambien sus contraseñas. 


Según hemos visto en la aplicación anterior, para autenticar a un usuario ne- 
cesitamos un formulario que solicite sus credenciales. Para esto, podemos utilizar 
el control Login, que presenta una vista análoga a la siguiente: 


Nombre de usuario: * 
Contraseña: Æ 
M Recordármelo la próxima vez. 


Inicio de sesión 


Así mismo, si necesitamos visualizar diferentes contenidos para diferentes 
usuarios, basados en si el usuario está o no autenticado, y si lo está, qué funciones 
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(qué rol o papel) del sitio web tiene, podemos hacerlo de una forma sencilla a tra- 
vés del control LoginView. Este control puede presentar tres vistas (plantillas): 


e  AnonymousTemplate. Esta plantilla será visualizada cuando el usuario que 
intenta acceder al sitio web no está autenticado. 


e LoggedInTemplate. Esta plantilla será visualizada cuando el usuario que in- 
tenta acceder al sitio web ya está autenticado, pero no pertenece a alguna de 
las funciones definidas. 


e RoleGroups. Esta plantilla será visualizada cuando el usuario que intenta 
acceder al sitio web ya está autenticado y pertenece a alguna de las funciones 
definidas. 


Para definir los usuarios, así como las funciones a las que pertenecen, el con- 
trol LoginView proporciona en su menú de tareas una orden Administrar sitio 
web que inicia el asistente para la configuración de seguridad que le ayudará a 
configurar la seguridad del sitio web. 


Puede configurar usuarios individuales y, de manera opcional, funciones o 
grupos para dichos usuarios. Al crear usuarios y funciones, podrá garantizar la se- 
guridad de todo el sitio o de partes del mismo, personalizar el contenido y realizar 
un seguimiento del uso del sitio. 


Después de establecer los usuarios y las funciones, puede permitir y denegar 
el acceso a carpetas específicas de la aplicación por el nombre de usuario o por la 
función que desempeña. Así mismo, puede establecer permisos para usuarios que 
no inician sesión en la aplicación (usuarios anónimos). 


Es también una buena idea proporcionar al usuario que intenta autenticarse in- 
formación acerca de cómo concluye la operación. Para ello, utilizaremos el con- 
trol LoginStatus. 


Como ejemplo, vamos a crear un sitio web ubicado en IIS (HTTP) que deno- 
minaremos WebSiteLogin, con una página Default.aspx. Una vez construido, aña- 
da una nueva página web denominada /login.aspx en una carpeta Cuenta. El hecho 
de colocar estas páginas de inicio de sesión en una carpeta permite restringir el 
acceso a las mismas. A modo de ejemplo, vamos a configurar la carpeta para per- 
mitir el acceso a los usuarios anónimos (usuarios que no están registrados) y de- 
negar el acceso a los usuarios autenticados (registrados). Para ello, agregue a la 
carpeta un fichero de configuración, Web.config, con el siguiente contenido: 


<configuration> 
<system.web> 
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<authorization> 
<allow users="2"/> 
<deny users="*"/> 
</authorization> 
</system.web> 
</configuration> 


Después, diríjase a la caja de herramientas y arrastre desde el panel Inicio de 
sesión un control Login sobre esta página. Abra el menú de tareas de este control 
y ejecute la orden Formato automático. Seleccione en el diálogo que se visualiza 
el formato que desee; por ejemplo, el Profesional: 











fr a 
Autoformato (9 je) 
Seleccione un esquema: Vista previa: 

Quitar formato 

E 

Profesional! r 

Simple Nombre de usuario: e 

Clásica Contraseña: * 


Multicolor > Jan 
M Recordármelo la próxima vez. 


Inicio de sesión 


+ 


[Aceptar] | Cancelar | [ Aplicar 


` A 









































A continuación diríjase a la ventana de propiedades y asigne a la propiedad 
DestinationPageUrl el valor “~/Default.aspx”, página que será mostrada después 
de que el usuario se autentique. 


Muestre la página Default.aspx en la ventana de diseño y arrastre sobre ella 
un control LoginView. Abra su menú de tareas, seleccione la vista Anonymous- 
Template y escriba en ella el mensaje “Usted no está autenticado”. Después, elija 
la vista LoggedInTemplate y escriba en ella el mensaje “Usted ya está autentica- 
do”. La vista AnonymousTemplate se muestra a cualquier visitante del sitio web 
que no haya iniciado una sesión, y LoggedInTemplate, al usuario que inicia una 
sesión. 


Arrastre también sobre esta página un control LoginStatus. 
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El siguiente paso será configurar el sitio web. Para ello, muestre en la ventana 


de diseño la página Default. aspx, seleccione el control LoginView, abra su menú 
de tareas y ejecute la orden Administrar sitio web: 


Web.config login.aspx 
asp:LoginView# LOgInvieW 
LoginViewl Tareas de LoginView 
Usted no está autenticado 
ciar sesión 


















Editar RoleGroups... 


Vistas: | AnonymousTempl |x| 


Administrar sitio Web 























Inicia la herramienta Administración de sitios Web 


Se mostrará una ventana que pone a su disposición la herramienta de adminis- 


tración de sitios web. Esta ventana también puede abrirla ejecutando la orden 
Configuración de ASP.NET del menú Sitio web de Visual Studio. Como se puede 
observar en la figura siguiente, esta ventana presenta tres opciones: Seguridad 
(editar usuarios y funciones), Configuración de la aplicación y Configuración del 
proveedor de suscripciones. 





r 












miti 


AS 


l http://localhost:6789/asp.netwebadminfiles/security/security.aspx 















(EN 
















ES http://localhost:6789/asp.netwebadminfile O ~ B © 


Pp Herramienta Administración de sitios Web ¿Cómo puedo utili h ? 


Página Seguridad Aplicación 
principal 


Herramienta Administración de sitios Web 





| uy 







| (2 Administración de la apl... X 













Proveedor 





Aplicación:/WebSiteLogin 
Nombre actual del usuario:FJCEBALLOS-PC\FJCEBALLOS 


Le permite configurar y editar usuarios, roles y permisos de acceso para el sitio. 
El sitio está utilizando la autenticación de Windows para la administración de 


usuarios. 
Configuración de la s sd di EA 
aplicación Le permite administrar los valores de configuración de la aplicación. 
Configuración del Le permite especificar dónde y cómo almacenar los datos de administración 
proveedor utilizados por el sitio Web. 





Para empezar, haga clic en Seguridad. Se le mostrará una ventana que le per- 
rá configurar usuarios, funciones (roles) y reglas de acceso. Quizás, llevar a 


cabo estas operaciones resulte más sencillo si hace clic en el enlace “Utilice el 
Asistente para la configuración de seguridad para configurar la seguridad paso a 
paso”. Haga, por lo tanto, clic en este enlace (se muestra una página de bienveni- 


da), 


y después en Siguiente. 
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El primer paso que debe realizar para garantizar la seguridad del sitio es iden- 
tificar a los usuarios (autenticación). El método para establecer la identidad de un 
usuario depende de la manera en que el usuario obtiene acceso al sitio. 


Seleccionar el método de acceso Desde Internet. Haga clic en Siguiente. 


Almacén de datos. La aplicación está configurada actualmente para utilizar 
configuración de proveedores avanzada (en la pestaña Proveedor puede ver para 
qué proveedor está configurada la aplicación; por ejemplo, para AspNetSqlPro- 
vider). Si lo desea, puede cambiar la manera en que se almacenarán los datos de 
administración de sitios web. Nosotros dejamos el tipo de almacén predetermina- 
do. Haga clic en Siguiente. 


Definir funciones. Opcionalmente, puede agregar funciones que le permitirán 
otorgar o denegar acceso a carpetas específicas del sitio web a grupos de usuarios. 
Por ejemplo, puede crear funciones como “administradores”, “ventas” o “miem- 
bros” cada una con diferente acceso a carpetas específicas. Después, puede agre- 
gar usuarios a estas funciones. Haga clic en Siguiente. 


Agregar nuevos usuarios. Para agregar un usuario, escriba el nombre, la con- 
traseña y la dirección de correo electrónico del usuario en esta página. Así mismo, 
puede especificar una pregunta con la respuesta que el usuario debe proporcionar 
para restablecer la contraseña o solicitar la contraseña olvidada. La contraseña de- 
be contener letras, dígitos y caracteres especiales. Cuando haya completado el 
formulario, haga clic en Crear usuario y después en Continuar. Repita este proce- 
so para añadir nuevos usuarios. Cuando termine haga clic en Siguiente. 





r EN 


«BE 


Paso 5: Agregar nuevos usuarios 















Paso 6: Agregar nuevas reglas de acceso > 
Regístrese para obtener una nueva cuenta 





Paso 7: Completar 


Nombre de usuario: 














Contraseña: 

Confirmar contraseña: 
Correo electrónico: 
Pregunta de seguridad: 


Respuesta de 
seguridad: 


Administración de seguridad 











Usuario activo 














usuario1 


























usuario1(MHcorreo.es 








pi 














ri 





Crear usuario 








D 
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Agregar nuevas reglas de acceso. Si se definen varias reglas, se aplicarán en 
el orden en el que aparecen en la tabla. Se aplicará la primera regla que coincida. 
Cuando termine haga clic en Siguiente. 


El asistente para la configuración de seguridad se ha completado. Haga clic en 
Finalizar. 


Más adelante podrá agregar, eliminar y modificar los usuarios, las funciones y 
las reglas, según puede observar en la ventana siguiente: 














| e Administración de la apl... X 



















ómo puedo utilizar esta herramienta? (09) A 


ASP Herramienta Administración de sitios Web ¿O 


Página principal | 








Puede utilizar la herramienta Administración de sitios Web para administrar la configuración de 
seguridad de la aplicación. Puede establecer usuarios y contraseñas (autenticación), crear 
roles (grupos de usuarios) y crear permisos (reglas para controlar el acceso a partes de la 
aplicación). 


De manera predeterminada, la información de usuario se almacena en una base de datos de 
Microsoft SQL Server Express, en la carpeta Datos del sitio Web. Si desea almacenar esta 


información en otra base de datos, utilice la pestaña Proveedor para seleccionar un proveedor 
diferente. 


Utilice el Asistente para la configuración de seguridad para configurar la seguridad paso a paso. 





Haga clic en los vínculos de la tabla para administrar la configuración de la aplicación. 


ree 


Usuarios existentes: 2 Los roles no están habilitados Crear reglas de acceso 
Crear usuario Habilitar roles Administrar reglas de acceso 
Administrar usuarios Crear o administrar roles 


Seleccionar tipo de 
autenticación 














Eche una ojeada al contenido del fichero de configuración del sitio web. Ob- 
servará que la autenticación es mediante formularios. Edite el atributo loginUrl de 


forms para especificar la dirección URL a la que debe redirigirse la solicitud de 
inicio de sesión. 





<system.web> 
<authentication mode="Forms"> 
<forms loginUrl="=/Cuenta/login.aspx" 
defaultUrl="-=/" timeout="2880" /> 
</authentication> 
</system.web> 


El control Login requiere la biblioteca jQuery. Por lo tanto, según explicamos 
en el apartado Controles de validación del capítulo Formularios web, utilizando 
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el administrador NuGet, añada esta biblioteca al proyecto y añada también el fi- 
chero Global.asax, para poder crear en el controlador del evento Start del objeto 
Application un ScriptResourceDefinition con nombre jquery que haga referencia 
a la ubicación de la biblioteca: 


void Application_Start(object sender, EventArgs e) 
( 
ScriptManager.ScriptResourceMapping.AddDefinition("jquery", 
new 
( 
Path = "-/scripts/jquery-2.0.3.min.js”, 
DebugPath = "-/scripts/jquery-2.0.3.js", 
CdnPath = "http://ajax.aspnetedn.com/ajax/jQuery/jquery-2.0.3.min.js", 
CdnDebugPath = "http: //ajax.aspnetedn.com/ajax/jQuery/jquery-2.0.3.js" 
) 


Js 


Eche una ojeada también al explorador de soluciones. Observará que se ha 
creado una carpeta App Data que almacena la base de datos ASPNETDB.MDF 
con los datos de los usuarios que ha creado. Probablemente tendrá que dar permi- 
so de escritura al grupo de usuarios 1/S JUSRS para el acceso a la base de datos. 





¿2 Administración de equipos Ela g 





Archivo Acción Ver Ayuda 





2% Administración del equipo 








a Ü} Herramientas del sister 
@ Programador de tari | Conexiones 
Visor de eventos La] 

¡Él Carpetas compartida | -%3 FICEBALLOS-PC (ficeballd 
dEl Usuarios y grupos lc E) Grupos de aplicaciong] 
®© Rendimiento a- Sitios Nombres de grupos o usuarios: 


El Administrador de di: 4 £%) Default Web Site 82, Administradores ficeballos-PC Administradores) 
$2, Usuarios ficeballos-PCUsuarios) 























Personalizar | 





Nombre de objeto:  CAinetpub\wwwroot\WebSteLogin 










a 2 Almacenamiento £ aspnet_client ball l Administrar 
[5% Administración de di 9 WebsSiteLogin aplicación 2 
a Ey Servicios y Aplicaciones = Examinar aplicación 
W} Administrador de In| E: 


haga clic en Editar. 


4 Servicios Permisos de IIS_IUSRS 


E) Control WMI 
Gf Administrador de col 





Control total 
Modificar 
i S y Lectura y ejecución 
= Mostrar el contenido de la capeta 
Lectura 






































Para especificar permisos especiales o [ y 
avanzadas 
configuraciones avanzadas, haga cic Ù SPSones 
en Opciones avanzadas. 
Obtener más información acerca de control y permisos de acceso 


Cancelar Aplicar 




















Compile y ejecute (http://localhost/WebSiteLogin) la aplicación. Si el usuario 
que accede al sitio web no está entre los usuarios dados de alta en la base de da- 
tos, no podrá ser identificado, lo que le será indicado con un mensaje “Usted no 
está autenticado”. Podrá volver a intentarlo haciendo clic en el vínculo “Iniciar se- 
sión” mostrado por el control LoginStatus. 
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O i | Æ http://localhost/WebSiteLogin/ 





Usted no está autenticado 
Iniciar sesión 





Haga clic en Iniciar sesión. Se mostrará la página web login. aspx: 





E 


a E http://localhost/WebSiteLogin/Cuenta/login.aspx?Reti 











Iniciar sesión 
Nombre de usuario: [usuario1 

















Contraseña: |+...oo.s. 














Recordármelo la próxima vez. 


Inicio de sesión 








Introduzca un nombre de usuario y una contraseña válidos. Cuando el usuario 
es autenticado, se le muestra la página web Default.aspx. Esta página muestra el 
mensaje especificado en la vista LoggedInTemplate del control LoginView, y el 
control LoginStatus muestra el enlace “Cerrar sesión”. 


E 
e) 18 http:/focalhost/WebSiteLogin/ 
Y! 


Usted ya está autenticado 
Cerrar sesión 

















Si el nombre de usuario y/o la contraseña no son válidos, el propio control 
Login se lo indicará con un mensaje. Observe que el mensaje es el valor asignado 
a la propiedad FailureText de este control. 
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E 
[€ ¡e http://localhost/WebSiteLogin/Cuenta/login.a u 











Iniciar sesión 
Nombre de usuario: |usuario3 

















Contraseña: 

















Recordármelo la próxima vez. 
El intento de conexión no fue correcto. Inténtelo de nuevo. 


Inicio de sesión 








En este último caso, también se puede redirigir al usuario a una página que le 
permita darse de alta como un nuevo usuario, o bien recuperar la contraseña si es 
que la olvidó. Para estos casos hay que configurar las propiedades CreateUser- 
Text, CreateUserUrl, PasswordRecoveryText y PasswordRecoveryUrl del 
control Login análogamente a como se indica a continuación: 


CreateUserText="Nuevo usuario" 
CreateUserUrl="-/Cuenta/nuevoUsuario.aspx"” 
PasswordRecoverylext="¿0lvidó su contraseña?" 
PasswordRecoveryUrl="-/Cuenta/olvidóContraseña.aspx" 





La configuración de estas propiedades hace que el control Login visualice los 
enlaces especificados, según puede observarse en la figura siguiente: 





|- 








(€) ES http://localhost/WebSiteLogin/Cuenta/login.aspx?Retur 











Iniciar sesión 
Nombre de usuario: 














Contraseña: 




















Recordármelo la próxima vez. 


Nuevo usuario 


¿Olvidó su contraseña? 











Puede modificar el mensaje especificado en la vista AnonymousTemplate del 
control LoginView para que ahora visualice lo siguiente: Haga clic en “Iniciar 
sesión” para autenticarse. Si no está registrado en este sitio web, puede hacerlo 
haciendo clic en “Nuevo usuario” del formulario login. 


Para probar lo expuesto, añada las páginas web nuevoUsuario.aspx y olvidó- 
Contraseña.aspx. A continuación, diríjase a la caja de herramientas y arrastre 
desde el panel Inicio de sesión un control CreateUserWizard sobre la página 
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nuevoUsuario.aspx y un control PasswordRecovery sobre la página olvidóCon- 
traseña.aspx. La vista que presentarán estos controles dependerá de la elección 
que realicemos tras ejecutar la orden Formato automático de su menú de tareas. 
Nosotros hemos elegido el formato profesional. 


El control CreateUserWizard se corresponde con una página estándar de re- 
gistro de usuarios. La apariencia de la interfaz generada por este control depende 
del valor que se asigne a sus propiedades. De forma predeterminada, su aparien- 
cia, bajo el formato profesional, es como se muestra a continuación: 


r 
(€) @ http://localhost/WebSiteLogin/Cuenta/nuevoUsua 


Regístrese para obtener una nueva cuenta 


Nombre de usuario: 


























Contraseña: 











Confirmar contraseña: 








Correo electrónico: 








Pregunta de seguridad: 








Respuesta de seguridad: 











Crear usuario 





Una de las cosas más interesantes que se puede hacer con este control es en- 
viar automáticamente un mensaje de correo para notificar al usuario que solicitó 
registrarse que su operación se completó con éxito. Para configurar el mensaje de 
correo hay que asignar valores a la propiedad MailDefinition del control. Esta 
propiedad representa un objeto que contiene la configuración requerida para defi- 
nir un mensaje de correo. Por ejemplo: 


<asp:CreateUserWizard ID="CreateUserWizard1" Runat="server" 
ContinueDestinationPageUrl="-/Default.aspx"> 
<MailDefinition 
BodyFileName="-/Cuenta/CorreoAUsuarioNuevo.txt" 
From="remitenteedominto" 
Subject="Bienvenido a WebSiteLogin"> 
</MailDefinition> 
</asp:CreateUserWizard> 


Este código indica que el control CreateUserWizard1 enviará a cada nuevo 
usuario que se registre en este sitio un mensaje con el asunto “Bienvenido a Web- 
SiteLogin” y con el cuerpo correspondiente al contenido del fichero CorreoA- 
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UsuarioNuevo.txt (añada este fichero al proyecto). Para ello, el control utiliza el 
servidor de correo especificado en el fichero de configuración Web.config: 


<configuration xmlns="http://..."> 


<system.net> 
<mailSettings> 
<smtp deliveryMethod="Network"> 
<network host="localhost" /> 
</smtp> 
</mailSettings> 
</system.net> 
</configuration> 





Puede echar una ojeada al fichero machine.config.comments de c:\windows\- 
microsoft.netlframeworklvn.n.mmmmmlconfig. 


En el fichero .txt se pueden utilizar expresiones como <% UserName %> y 
<% Password %> para que sean sustituidas en el cuerpo del mensaje con el nom- 
bre y la contraseña del usuario registrado. 


Lo expuesto anteriormente solo funcionará correctamente si tiene configurado 
un servidor SMTP de IIS. Si no lo tiene, siga los pasos indicados a continuación 
para configurarlo. 


En Windows Vista, 7 o superior se le mostrará la ventana que puede observar 
en la figura siguiente. Para ello siga los pasos indicados a continuación: 














BY Administración de equipos l O] pa 
Archivo Acóón Ver Ayuda 
++» 120 
BE Administración del equipo rae [> FICEDALLOS-PC » Sitios » Default Web Site » ERr 
4 il Herramientas del sister 
(3) Programador de tar | Conexiones @ Acciones 
ai Página principal de Default 
lá Visor de eventos 2 g Y p! pa Default t 
F Carpetas compartida | 4-93 FICEBALLOS-PC (fcebalk Web Site a 
Æ Usuarios y grupos le 2 Grupos de aplicacione J ar pe o 
($ Rendimiento + dl Sitios Eu > Herr a ORTA 
dl Adminstrador de dis Default Web Site Administración Ẹ 
a 2 Almacenamiento J 14) 


È? Administración de de 
a i Servicios y Aplicadones 
Wh Administrador de In 


Editor de Instalador de 
configuración plataforma web 





3 Sernos Administrar sitio A 
S Control WMI ASP.NET web 
(1 Admmistrador de co E A y 2 
ab 7 
Cadenas de Clave del Compiladón de [e 
conexión equipo NET E = 
m minar sitio web 
B [H] £ 
Configuración Correo Estado de la 


de aplicaciones | electrónico | sesión Configurar 
SMTP | te 





pifi m » | [F Vista Características UÈ Vista Contenido se 
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1. Utilizando el botón secundario del ratón, haga clic en Equipo y seleccione 
Administrar. Después, seleccione Administrador de IIS y navegue hasta el ni- 
vel que desee: servidor web, sitio, aplicación, directorios físicos y virtuales o 
archivo (dirección URL). 


2. En la página principal, haga doble clic en Correo electrónico SMTP. 


3. Enel panel Correo electrónico SMTP, escriba en la caja Servidor SMTP la di- 
rección de correo electrónico del remitente. 


4. En el mismo panel, seleccione uno de los métodos de entrega siguientes: 


a. Entregar correo electrónico a servidor SMTP. Este método requiere un 
servidor SMTP operativo para el que el usuario tenga credenciales. 


b. Almacenar correo electrónico en directorio de recogida. Este método re- 
quiere especificar un directorio en su sistema de ficheros para almacenar 
los correos electrónicos que posteriormente serán entregados por una apli- 
cación como ASP.NET o por un usuario, como un administrador. Puede 
crear este directorio, por ejemplo mensajes, en el propio sitio web y debe- 
rá tener permiso de escritura para el usuario Servicio de red o ASPNET. 











BY Administración de equipos l œj p 
Archivo Acóón Ver Ayuda 
++ am 
ale R AE 6 Ey [P » FICEBALLOS-PC » Sitios » Default Web Site » WebSiteLogin » a- ae- 
a U} Herramientas del sister E 
(3) Programador de tar | Conexiones 4 Meciones 
Visor de eventos: [| % Correo electrónico SMTP 
i 
B Carpetas compartida | 4-93 FICEBALLOS-PC (fjcebalk | Utilice esta característica para especificar las opciones x 
S Usuarios y grupos le 3 Grupos de aplicaione | de direcaón de correo electrónico y entrega que se v 
@ Rendimiento a i Sitios deben usar cuando envie correo electrónico desde una 
él Adminestrador de de 4 @ Default Web Site aplicación web. 
Correo electrónico: 
a ES Almacenamiento T) aspnet_dient 
È? Admimistración de di P WebSite cerros 
a D Servicios y Aplicadones Y WebSiteLogin 


Me Administrador de lo % Entregar correo electrónico a servidor SMTP: 


Servicios 
E) Control WMI smtpuah.es 
MN Administrador de co' 


Servidor SMTP: 


Usar localhost 
Pueno: 
25 

Configuración de autenticación 


© No requerido 


Windows < 


4 





1 Vista Características [Ll Vista Contenido 














5. En el caso a, escriba el nombre del servidor SMTP o active la casilla Usar lo- 
calhost (en este último caso, ASP.NET utilizará un servidor SMTP en el 
equipo local, normalmente, el servidor virtual SMTP predeterminado), especi- 
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fique el puerto TCP (25 es el puerto TCP estándar de SMTP) y la configura- 
ción de autenticación. 


6. Y enel caso b, especifique el directorio del correo electrónico en la caja de 
texto Almacenar correo electrónico en directorio de recogida. 


7. Finalmente, haga clic en Aplicar en el panel Acciones (se escribirá en el fiche- 
ro Web.config la sección <system.net></system.net>). 


El control PasswordRecovery se corresponde con una página estándar para 
solicitar una contraseña olvidada. Igual que con el control CreateUserWizard, 
hay que definir los atributos del mensaje de correo enviado al usuario en la pro- 
piedad MailDefinition: 


<asp:PasswordRecovery ID="PasswordRecoveryl1" runat="server"> 
<MailDefinition 
BodyFileName="-/Cuenta/CorreoA0lvidóContraseña.txt" 
From="remitenteeadominto" 
Subject="Contraseña olvidada"> 
</MailDefinition> 
</asp:PasswordRecovery> 


De forma predeterminada, su apariencia, bajo el formato profesional, es la si- 
guiente: 











r 
a e http://localhost/WebSiteLogin/Cuenta/olvid%C3%B3Contra 


¿Olvidó su contraseña? 
Escriba su Nombre de usuario para recibir su contraseña. 


Nombre de usuario: 























En el fichero .txt se pueden utilizar expresiones como <% UserName %> y 
<% Password %> para que sean sustituidas en el cuerpo del mensaje con el nom- 
bre y la contraseña del usuario que realizó la petición. 


Para poder recuperar la contraseña y enviársela al usuario es necesario asignar 
al atributo enablePasswordRetrieval del proveedor de suscripciones el valor 
true, y al atributo passwordFormat, un valor distinto de Hashed (Clear o En- 
crypted). Utilice la expresión <% Password %> en el cuerpo del mensaje enviado 
al usuario para notificarle a este la contraseña que olvidó. 
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Para modificar los atributos citados del proveedor de suscripciones hay que 
incluir el elemento <membership> en la sección <system.web>. Por ejemplo: 


<membership> 
<providers> 
<add name="AspNetSqlProvider" 
type="System.Web.Security.SqlMembershipProvider" 
connectionStringName="LocalSqlServer" 
enablePasswordRetrieval="true" 
requiresQuestionAndAnswer="true" 
applicationName="/" 
passwordFormat="Clear" /> 
</providers> 
</membership> 


La pregunta y la respuesta de seguridad para recuperar una contraseña olvida- 
da solo se harán si el atributo requiresQuestionAndAnswer vale true, que es el 
valor que tiene asignado por omisión. En el ejemplo anterior se ha especificado 
este atributo explícitamente solo por motivos didácticos. 


Puede echar una ojeada al fichero machine.config.comments de c:\windows\- 
microsoft.netlframeworklvn.n.mmmmmlconfig. 


Otros dos controles relacionados con la seguridad son ChangePassword y 
LoginName. El primero permite al usuario cambiar su contraseña. Igual que su- 
cede con los controles CreateUserWizard y PasswordRecovery, en este control 
también es necesario configurar la propiedad MailDefinition. El segundo muestra 
el nombre del usuario actualmente autenticado. 


SERVICIO DE SUSCRIPCIONES 


El servicio de suscripciones de ASP.NET (ASP.NET membership) permite validar 
y almacenar las credenciales de un usuario. También se puede utilizar junto con 
los controles de seguridad vistos en el apartado anterior para crear un sistema 
completo de autenticación de usuarios. Este servicio, básicamente, proporciona 
soporte para crear nuevos usuarios y contraseñas, almacenar la información de 
cada usuario en una base de datos (SQL Server, Access, etc.), autenticar a los 
usuarios que visiten el sitio web y administrar las contraseñas. La figura siguiente 
muestra este servicio y su relación con el resto de los elementos de seguridad: 
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Controles de seguridad 





Código de la aplicación 


























API del servicio de suscripciones 











Proveedores de bases de datos del servicio de suscripciones 




















Base de datos 











Para utilizar el servicio de suscripciones primero hay que configurarlo para el 


sitio web. Para ello, en líneas generales, hay que hacer lo siguiente: 


1. 


Especificar las opciones del servicio de suscripciones como parte de la confi- 
guración del sitio web (fichero Web.config, sección system.web, elemento 
membership). Por ejemplo: 


<system.web> 
<membership> 
<providers> 
<add name="AspNetSqlProvider" 
type="System.Web.Security.SqlMembershipProvider" 
connectionStringName="LocalSqlServer" 
enablePasswordRetrieval="true" 
applicationName="/" 
passwordFormat="Clear" /> 
</providers> 
</membership> 
</system.web> 


De forma predeterminada, el servicio de suscripciones está activado y el pro- 
veedor de base de datos es SqlIMembershipProvider. 
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2. Configurar la aplicación para que utilice autenticación mediante formularios. 


<system.web> 
<authentication mode="Forms" /> 
</system.web> 


3. Definir las cuentas de usuario. Según vimos en el apartado anterior, esto pue- 
de hacerse de varias formas; por ejemplo, mediante la herramienta de admi- 
nistración de sitios web, mediante el control CreateUserWizard, o bien po- 
demos tomar los datos nombre de usuario y contraseña y utilizar el método 
CreateUser de la API del servicio de suscripciones. 


Una vez realizados los pasos anteriores, podremos utilizar páginas web perso- 
nalizadas, controles de seguridad, o bien la API del servicio de suscripciones para 
proporcionar seguridad a nuestra aplicación ASP.NET. 


Las dos clases principales de esta API son Membership y MembershipUser 
del espacio de nombres System.Web.Security. La primera expone la mayoría de 
la funcionalidad proporcionada por el servicio de suscripciones: crear, actualizar, 
borrar y recuperar usuarios, y validar las credenciales de un usuario. La segunda 
clase es la representación de un usuario durante la ejecución. 


Para poner en práctica lo expuesto, vamos a añadir a nuestra aplicación una 
página web, usuariosSuscritos, que muestre una tabla con cuatro columnas: el 
nombre del usuario, su dirección de correo, fecha de su último acceso y si está o 
no conectado. ¿Quién podrá acceder a esta página? Una tarea típica en muchos si- 
tios web es configurar páginas para que solo puedan verlas ciertos usuarios auten- 
ticados. Por ejemplo, podríamos programar que solo pudieran acceder a esta pági- 
na los usuarios autenticados que pertenecieran al grupo de “Administradores”. 


Según lo expuesto, vamos a añadir a nuestra aplicación la página web usua- 
riosSuscritos, pero en una nueva carpeta denominada Admin que, como veremos 
posteriormente, definirá un área de seguridad: solo podrán acceder a esta carpeta 
los usuarios que tengan la función de “Administradores”. Esto supone, además, 
crear la función “Administradores”, crear, al menos, un usuario que tenga esta 
función y crear las reglas para acceder a la carpeta Admin. 


Para añadir la nueva carpeta, haga clic con el botón secundario del ratón sobre 
el nombre del proyecto y ejecute Agregar > Nueva carpeta. Denomine a la carpe- 
ta Admin. Una vez añadida la carpeta, haga clic con el botón secundario del ratón 
sobre el nombre de la misma y ejecute Agregar nuevo elemento > Formularios 
Web Forms para añadir la página usuariosSuscritos.aspx. A continuación, añada 
sobre la página un control GridView que configuraremos más adelante. 
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Muestre en el diseñador la página Default.aspx para establecer sobre la misma 
un enlace con la página usuariosSuscritos.aspx. Para ello, desde la caja de herra- 
mientas, arrastre sobre Default.aspx un control HyperLink y asigne a su propie- 
dad NavigateUrl el valor “-/Admin/usuariosSuscritos.aspx” y a Text el valor 
“Usuarios suscritos”. 


El siguiente paso es añadir la función “Administradores”. Los usuarios que 
tengan esta función podrán acceder a la página usuariosSuscritos.aspx. Para ello 
ejecute la orden Configuración de ASP.NET del menú Sitio web. En la página que 
se visualiza, haga clic en Seguridad. Después, haga clic en Habilitar funciones 
(roles) y a continuación en Crear o administrar funciones. Escriba como Nombre 
nuevo de función “Administradores” y, después, haga clic en Agregar función. 


A continuación, añadiremos un usuario que tenga la función de “Administra- 
dores”. Vuelva a la página principal, haga clic en Seguridad y, después, en Crear 
usuario. A continuación, escriba los datos para este nuevo usuario. 


Obsérvese en la figura siguiente que además de escribir los datos del usuario, 
se le ha asignado la función “Administradores”. Haga clic en Crear usuario y 
después en Continuar. 





f sa 














Seleccione roles para este usuario: 


Regístrese para obtener una nueva cuenta 
Nombre de usuario: [admin a 











Contraseña: [+eeroorccros 





Confirmar contraseña: [+e.oocssnes 











Correo electrónico: |adminQuah.es 








Pregunta de seguridad: |pa 














Respuesta de 
seguridad: 





Crear usuario 











Y]Usuario activo 





7 


£ > 




















Vuelva a la página principal para añadir ahora las reglas de acceso al sitio 
web. Haga clic en Seguridad > Crear reglas de acceso. La primera regla permiti- 
rá acceder a la carpeta Admin a los usuarios con función “Administradores”. Por 
lo tanto, seleccione Admin > Rol Administradores > Permitir y, después, haga clic 
en Aceptar. 
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>) Æ http://localhost:3333/asp.netwebadminfiles/secu P ~ B © | (2 Administración de la apl... * | | 








D w i 








Opcionalmente, puede agregar reglas de acceso para controlar el acceso a todo el sitio 
web o a carpetas individuales. Las reglas pueden aplicarse a usuarios y roles 
específicos, a todos los usuarios, a usuarios anónimos o a alguna combinación de estos. 
Las reglas se aplican a las subcarpetas. 


Agregar nueva regla de acceso 


Seleccione un directorio para La regla se aplica a: 

esta regla: 

(3  WebsSiteLogin 
Admin 
App_Data 
Cuenta 


Permiso: 











(9) Rol | Administradores V (8) Permitir 





O usuario 











O Denegar 





Buscar por usuarios 
Scripts 


O Todos los usuarios 


O Usuarios anónimos 














Haga clic de nuevo en Crear reglas de acceso. La segunda regla denegará el 
acceso a la carpeta Admin a todos los usuarios. Por lo tanto, seleccione Admin > 
Todos los usuarios > Denegar y, después, haga clic en Aceptar. 

















Opcionalmente, puede agregar reglas de acceso para controlar el acceso a todo el sitio 
web o a carpetas individuales. Las reglas pueden aplicarse a usuarios y roles 
específicos, a todos los usuarios, a usuarios anónimos o a alguna combinación de estos. 
Las reglas se aplican a las subcarpetas. 


Agregar nueva regla de acceso 


Seleccione un directorio para La regla se aplica a: 

esta regla: 

(03  WebsSiteLogin 
Admin 
App_Data 
Cuenta 
Scripts 


Permiso: 





O Rol | Administradores w O Permitir 











O usuario 











O] Denegar 





Buscar por usuarios 


(9) Todos los usuarios 


O Usuarios anónimos 














Como la regla que se aplica es la primera que coincida según el orden estable- 
cido, a la carpeta Admin solo podrán acceder los usuarios que tengan la función de 
“Administradores”. Ahora tenemos una carpeta Admin segura. Si hace clic en 
Administrar reglas de acceso, podrá observar las reglas establecidas: 
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[ES 


r 
a Æ http://localhost:3333/asp.netwebadminfiles/secu P ~ BG | (2 Administración de la apl... » | in Y 




















Utilice esta página para administrar las reglas de acceso al sitio Web. Las reglas se aplican en orden. Se 
aplica la primera regla que coincide y los permisos de cada regla reemplazan los permisos de las siguientes. 
Utilice los botones Subir y Bajar para cambiar el orden de la regla seleccionada. 


Las reglas que aparecen atenuadas se heredan del sitio principal y no pueden cambiarse en este nivel. 


Administrar reglas de acceso 


= (3  WebsSiteLogin 
O Admin 
© App_Data |: PA 
© Cuenta 
© Scripts 





E| roos 
| Permitir Us] [todos] 


Agregar nueva regla de acceso 














Cierre el administrador de sitios web y eche una ojeada al fichero de configu- 
ración Web.config que se ha creado en la carpeta Admin: 


<system.web> 
<authorization»> 
<allow roles="Administradores" /> 
<deny users="*" /> 
</authorization> 
</system.web> 


Si ahora ejecuta la aplicación, comprobará que solo el usuario Admin puede 
acceder a la página usuariosSuscritos.aspx. 


Para que el control GridView de usuariosSuscritos.aspx muestre la informa- 
ción deseada, haga doble clic sobre esta página y complete el controlador del 
evento Load como se indica a continuación: 


protected void Page_load(object sender, EventArgs e) 
{ 
GridViewl.DataSource = Membership.GetAllUsers(); 
GridViewl.DataBind(); 


En este método observamos que la fuente de datos para el control GridView 
(propiedad DataSource) es la colección, de tipo MembershipUserCollection, de 
objetos MembershipUser devuelta por el método GetAllUsers de la clase Mem- 
bership. Para establecer un vínculo entre esta fuente de datos y el control 
GridView hay que invocar a su método DataBind. 
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Si observamos la funcionalidad del objeto MembershipUser, veremos que, 
entre otras, tiene las propiedades UserName (nombre del usuario), Email (direc- 
ción del correo electrónico), LastActivityDate (fecha de cuando el usuario acce- 
dió por última vez a la aplicación) e IsOnline (devuelve true si el usuario está en 
línea), propiedades que nos proporcionarán los valores que deseamos mostrar. 


El siguiente paso es configurar las columnas de la tabla GridView! para que 
muestren los datos anteriormente señalados. Para ello, haga clic en la orden Editar 
columnas del menú de tareas del control DataGrid. En la ventana que se visuali- 
za, desactive la casilla Generar campos automáticamente, seleccione BoundField 
en la lista de campos disponibles, después haga clic en Agregar y complete los 
atributos HeaderText y DataField, respectivamente, con el título de la columna 
(por ejemplo, “Nombre del usuario”) y con el nombre de la propiedad que propor- 
ciona el dato (por ejemplo, UserName). El resultado será el siguiente: 











lepa Le) 

Campos disponibles: Propiedades de BoundField: 

| E BoundField a | E) | 
mi Campo CheckBox 4 Comportamiento 5 
A Campo HyperLink ApplyFormatinEditMo: False 
al ImageField F ConvertEmptyStringTc True 
A ButtonField HtmlEncode True 

 M CommandField HtmlEncodeFormatStri True 


sÅ TemplateField 


InsertVisible True 
NullDisplayText 


Agregar ReadOnly False 


ShowHeader True 


m 


Campos seleccionados: 5 SortExpression 


ñ Nombre del usuario 














t ValidateRequestMode Inherit z 
E Correo-e Visible True 
E Último acceso y] 4 Datos 
H ¿Está en línea? Pa] UserName sal. 
DataField 


Campo al que está enlazado este campo. 


























=] Generar campos automáticamente Convertir este informe en TemplateField 
Aceptar Cancelar 
Xx el 





Repita el proceso para el resto de las columnas. Cuando haya finalizado, se 
habrá añadido a la página usuariosSuscritos.aspx el código siguiente: 


<Columns> 
<asp:BoundField DataField="UserName" HeaderText="Nombre del usuario" /> 
<asp:BoundField DataField="Email" HeaderText="Correo-e" /> 
<asp:BoundField DataField="LastActivityDate" HeaderText="Último acceso" /> 
<asp:BoundField DataField="IsOnline" HeaderText="¿Está en línea?" /> 
</Columns> 
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Ejecute la aplicación y pruebe si su funcionamiento es el correcto. 


r 
O e http://localhost/W 








eLogin/Admin/usuariosSuscritos.asp 





Nombre del usuario Correo-e Último acceso (¿Está en línea? 
admin admin(Quah.es 30/07/2013 0:53:26 True 

usuario] usuario1(Acorreo.es|30/07/2013 0:36:38 False 

usuario2 usuario2(Acorreo.es|30/07/2013 0:39:54/True 

usuario3 usuario3(Acorreo.es|¡30/07/2013 0:40:21 True 





SEGURIDAD EN LA TRANSMISIÓN DE DATOS 


La seguridad tiene un amplio abanico de conceptos y de utilidades aplicables a 
determinadas situaciones en función de las necesidades del momento. En este 
punto lo que se pretende es resumir cada uno de estos conceptos y las situaciones 
en las que se pueden emplear con el fin de dotar a las aplicaciones de la seguridad 
necesaria, procurando que el rendimiento se vea afectado en lo mínimo posible. 


Imagínese una situación en la que un cliente y un servidor necesitan inter- 
cambiar información, y el servidor quiere estar seguro de que los mensajes que le 
llegan proceden realmente de un cliente auténtico, sin importarle que esos mensa- 
jes puedan ser vistos por terceras personas, ya que su contenido no es confiden- 
cial. 


Para que el servidor tenga esa seguridad se nos ocurre encriptar los mensajes 
con una contraseña secreta compartida únicamente entre el servidor y el cliente. 
Evidentemente, de esta forma, el servidor tendrá la seguridad de que los mensajes 
que le llegan proceden de un cliente auténtico. Pero ¿qué pasará si esos mensajes 
tienen un tamaño considerable? Pues que el proceso de encriptación se tomará su 
tiempo. ¿Y esto es malo? Posiblemente no sea malo si solo hay que atender a un 
cliente, pero cuando el número de clientes se incremente, el servidor empezará a 
saturarse, pues no podrá atender todas las peticiones, y hasta es posible que tarde 
más en desencriptar el mensaje que en procesar dicho mensaje. Vemos por tanto 
que este proceso no sería apropiado porque consume bastantes recursos y los 
mensajes no son confidenciales. Una posible solución a esta situación sería firmar 
los mensajes que intercambien el cliente y el servidor, de modo que se tenga la 
seguridad de quién es el verdadero emisor de los mensajes, sin que el contenido 
de los mismos quede oculto. Esta otra forma de proceder, como estudiaremos más 
adelante, consume menos recursos. 
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Criptografía simétrica 


La criptografía simétrica se caracteriza porque tanto en el cliente como en el ser- 
vidor se utiliza la misma clave para encriptar y desencriptar, de ahí el calificativo 
de simétrica. La figura siguiente nos da una idea de este sistema: 


Encriptación simétrica 


emisor | ---- F A y ------ | receptor 
se medio inseguro Sesa 
llave llave 


Toda la seguridad de este sistema está basada en la clave, la cual debe ser co- 
nocida y mantenida en secreto tanto por el emisor como por el receptor. Si la cla- 
ve cae en manos de terceros, el sistema dejará de ser seguro, por lo que habría que 
desechar dicha clave y generar una nueva. 





























Para que un algoritmo de este tipo sea considerado fiable, debe cumplir varios 
requisitos básicos: 


1. Conocido el criptograma (texto cifrado), no se pueden obtener de él ni el tex- 
to en claro (texto sin cifrar) ni la clave. 


2. Conocidos el texto en claro y el texto cifrado, debe resultar más caro en tiem- 
po o dinero descifrar la clave que el valor posible de la información obtenida 
por terceros. 


Los principales algoritmos simétricos actuales son DES, y la variante Triple- 
DES, IDEA y RC5. Actualmente se ha establecido un sistema simétrico estándar 
denominado AES (Advanced Encryption Standard), que se ha adoptado a nivel 
mundial. 


Las principales desventajas de los métodos simétricos son la distribución de 
las claves, el peligro de que muchas personas deban conocer una misma clave y la 
dificultad de almacenar y proteger muchas claves diferentes. 


Criptografía asimétrica 


La criptografía de clave asimétrica, también llamada de clave pública, se basa en 
el uso de dos claves diferentes que poseen una propiedad fundamental: una clave 
puede desencriptar lo que la otra ha encriptado. 
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Generalmente una de las claves de la pareja, denominada clave privada, es 
usada por el propietario para encriptar los mensajes, mientras que la otra, llamada 
clave pública, es usada para desencriptar el mensaje cifrado. 


Las claves pública y privada tienen características matemáticas especiales, de 
tal forma que se generan siempre a la vez, por parejas, estando cada una de ellas 
ligada intrínsecamente a la otra, de tal forma que si dos claves públicas son dife- 
rentes, entonces sus claves privadas asociadas también lo son, y viceversa. 


Los algoritmos asimétricos están basados en funciones matemáticas fáciles de 
resolver en un sentido, pero muy complicadas de realizar en sentido inverso, salvo 
que se conozca la clave privada; por ejemplo, es fácil multiplicar dos números 
primos para obtener uno compuesto, pero es difícil factorizar uno compuesto en 
sus componentes primos. Ahora bien, si tenemos un número compuesto por dos 
factores primos y conocemos uno de los factores, es fácil computar el segundo. 


Mientras que la clave privada debe mantenerla en secreto su propietario, ya 
que es la base de la seguridad del sistema, la clave pública es difundida amplia- 
mente por Internet, para que esté al alcance del mayor número posible de perso- 
nas, existiendo servidores que guardan, administran y difunden dichas claves. La 
figura siguiente nos da una idea de este sistema: 


Encriptación de clave pública 























A se E = E ES B 
emisor | ------ medio inseguro P o j receptor 
clave clave 
pública de B privada de B 


En este sistema, para enviar un documento con seguridad, el emisor (A) en- 
cripta dicho documento con la clave pública del receptor (B) y lo envía por el me- 
dio inseguro. Este documento está totalmente protegido en su viaje, ya que solo se 
puede desencriptar con la clave privada correspondiente, conocida únicamente por 
B. Al llegar el mensaje cifrado a su destino, el receptor usa su clave privada para 
obtener el mensaje en claro. 


Una variación de este sistema se produce cuando es el emisor A el que encrip- 
ta un texto con su clave privada, enviando por el medio inseguro tanto el mensaje 
en claro como el cifrado. Así, cualquier receptor B del mismo puede comprobar 
que el emisor ha sido A, y no otro que lo suplante, con tan solo desencriptar el 
texto cifrado con la clave pública de A y comprobar que coincide con el texto sin 
cifrar. Como solo A conoce su clave privada, B puede estar seguro de la autenti- 
cidad del emisor del mensaje. Este sistema de autenticación, correspondiente a la 
figura, se denomina firma digital. 
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Firma digital 


clave clave i 


A Ñ Ae 
MA privada F: pública 
emisor medio inseguro 


























| B 
receptor 


















































El proceso de firma digital consta de las siguientes partes: 
1. El firmante cifra con su clave privada el documento. 
Entrega al receptor tanto el documento cifrado como el documento en claro. 


El receptor utiliza la clave pública del firmante para descifrar el documento. 


= 9 1 


Si el documento descifrado se corresponde con el documento en claro, la cla- 
ve firmada es válida; si no lo es, la firma no es auténtica. 


El firmante puede repudiar su firma argumentando que la clave pública que 
utiliza el receptor no es suya. Para evitar este problema, la clave pública debe ser 
universalmente conocida o autenticada por un organismo en el que todos confíen. 


AUTENTICACIÓN USANDO CERTIFICADOS 


Según comentamos al principio de este capítulo, la autenticación básica de Win- 
dows puede ser segura si habilitamos las características de cifrado de SSL (Secure 
Socket Layer) en la aplicación. 


SSL es un protocolo de seguridad desarrollado por la empresa Netscape 
Communications para lograr que la transmisión de datos entre un servidor y un 
usuario, o viceversa, a través de Internet, sea completamente segura. Se basa en la 
utilización de un sistema de cifrado que emplea algoritmos matemáticos y un sis- 
tema de claves que solamente conocen el usuario y el servidor. Estas claves per- 
miten la encriptación de los datos para que solo puedan ser leídos por aquellos 
que las tengan. Esto significa que cualquier tipo de información que se transmita 
desde un servidor seguro y utilizando un navegador con tecnología SSL viajará a 
través de Internet de forma segura. 


Para utilizar el protocolo SSL es necesario que el servidor de Internet que so- 
porte SSL (IIS lo soporta) se encuentre en posesión del certificado digital de segu- 
ridad correspondiente (certificado de servidor, otorgado por una agencia indepen- 
diente debidamente autorizada, por ejemplo Verisign o Microsoft Root Certificate 
Authority), y por parte del usuario, es preciso disponer de un navegador WWW 
que soporte el protocolo SSL (tanto Netscape, FireFox como Internet Explorer lo 
soportan). 
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Una autoridad de certificación (Certification Authority o CA) es la tercera par- 
te fiable que acredita la ligazón entre una determinada clave y su propietario real. 
Actúa como una especie de notario electrónico que extiende un certificado de cla- 
ves, el cual está firmado con su propia clave, para así garantizar la autenticidad de 
dicha información. 


Cuando se conecta a un servidor seguro (https://www...), los navegadores avi- 
san de esta circunstancia mediante un candado de color amarillo en la parte infe- 
rior y además permiten comprobar la información contenida en el certificado digi- 
tal que lo habilita como servidor seguro. 


Vamos a realizar un ejemplo en el que crearemos una aplicación web 
ASP.NET simple, asegurada con autenticación básica con conexión SSL (o 
HTTPS) de Windows. 


Inicie Visual Studio y cree un nuevo sitio web ASP.NET vacío ubicado en 
HTTP, de nombre WebSite2, utilizando Visual C#. Después, añada al sitio una 
página web. 


Arrastre sobre la página web tres controles de tipo Label y denomínelos 
etUsuarioAut, etUsuarioASP y etCertificado. 


A continuación, haga doble clic sobre la página y complete el método Pa- 
ge Load, que responderá al evento Load, como se indica a continuación: 


protected void Page_load(object sender, EventArgs e) 
( 
string UsuarioAutenticado; 
string UsuarioASP; 
// Usuario que realiza la solicitud de la página 
UsuarioAutenticado = User.Identity.Name; 
UsuarioASP = WindowsIdentity.GetCurrent().Name; 


etUsuarioAut.Text = "Usted es el usuario: " + UsuarioAutenticado; 
// Contexto de seguridad bajo el que se ejecuta la página 
etUsuarioASP.Text = "La página se ejecuta bajo el " + 

"contexto de seguridad: " + UsuarioASP; 








HttpClientCertificate certificado = Request.ClientCertificate; 
if (certificado.IsPresent) 
// Obtener el campo "organización" (0) del certificado 
etCertificado.Text = certificado.Get("Subject 0"); 
S 
e 




















e 
tCertificado.Text = " El certificado de cliente se ha omitido."; 
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Un objeto HttpClientCertificate proporciona los campos del certificado de 
un cliente como respuesta a la solicitud realizada por el servidor relativa a la iden- 
tidad de dicho cliente. 


Edite el fichero de configuración y asegúrese de que el modo de autenticación 
es Windows (recuerde que este modo es el predeterminado): 


<authentication mode="Windows"/> 


A continuación, configure IIS para requerir Autenticación básica para el sitio 
web WebSite2. Esto es, deshabilite la Autenticación anónima y habilite la Autenti- 
cación básica como ya se explicó anteriormente en este mismo capítulo. 


Compile la aplicación y ejecútela pulsando las teclas Ctrl+F3, o bien, de una 
forma más real, abriendo Internet Explorer y escribiendo la dirección URL: 


http: //localhost/WebSite2/Default.aspx 


Observará un resultado análogo al siguiente: 
Usted es el usuario: dominto|servidorYsu nombre de usuario 


La página se ejecuta bajo el contexto de seguridad: 
dominio|servidorYusuario ASP.NET 


El certificado de cliente se ha omitido. 


Lo cual es lógico porque aún no se ha instalado ningún certificado, ni en el 
servidor ni en el cliente. 


Para instalar un certificado lo normal es, en primer lugar, solicitarlo a una en- 
tidad emisora de certificados. No obstante, a efectos de verificación de aplicacio- 
nes ASP.NET, es suficiente con generar un certificado de prueba con alguna de 
las utilidades existentes. 


Instalar un certificado SSL en IIS 7.0 o superior 


La versión de IIS 7.0 fue incluida en Windows Vista y con respecto a versiones 
anteriores, instalar desde ella un certificado SSL es bastante más fácil. Lo primero 
es obtener el certificado para nuestro servidor; en nuestro caso, vamos a utilizar 
un certificado autofirmado de prueba. Para ello, abra el Administrador de IIS, se- 
leccione el nodo correspondiente al servidor y haga doble clic en el icono Certifi- 
cados de servidor: 
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Esta acción hará que se muestre el panel de Certificados de servidor. Entre las 
acciones que puede ejecutar, seleccione Crear un certificado autofirmado. Una 
vez ejecutada esta acción ya tenemos un certificado para utilizarlo en un sitio web 
y poder así habilitarlo para que admita conexiones HTTPS. Este sitio web puede 
ser el que ya tenemos (Default Web Site) u otro sitio web (podríamos crear un 
nuevo sitio web haciendo clic con el botón derecho del ratón sobre el nombre del 
servidor y ejecutando Agregar sitio web). 


















































ĝi 
¿E Administración de equipos lol 
Archivo Acción Ver Ayuda 
es [2 
¿Y Administración del equipo a) [@ > FICEBALLOS-PC » Sitios » Default Web Site » 
a Ü} Herramientas del sisten] 
Programador de tar | Conexiones ea E 
pb actes IN | @ Página principal de Default Web m 
ll Carpetas compartidz||| FICEBALLOS-PC (ficeballa Site 
Æ Usuarios y grupos lc |) Grupos de aplicacione: z = 
®© Rendimiento |) Sitios Filtro: + Bir + dz Mostrar todo 
El Administrador de dis | « €) Default Web Site| | ASP.NET Y 
a E2 Almacenamiento E aspnet_dient E w H 3 
3) Administración de di ($ WebSite2 a») á á a Ver directorios 
a És Servicios y Aplicaciones Cadenas de Clave del Compilación de 3 
conexión ¡ NET 
ú Administrador de In| j Saps 


| Administrar sitio 
Servicios web A 
E Control WMI E] [al b [2 Reiniciar 

ÉS) Administrador de co a 


























> » 
Configuración Correo Estado de la E Detener 
de aplicaciones electróni... sesión — - 
Examinar sitio web 
Z [8] Examinar *:80 (http) 
PEA A a” y Y 
« ma y lee n + | [E] Vista Características (13) Vista Contenido pl 





























Para que nuestro sitio web admita conexiones seguras HTTPS, seleccione el 
sitio y haga clic en Enlaces (véase figura anterior). A continuación, según muestra 
la figura siguiente, observe en la ventana que se visualiza que este sitio no tiene 
un enlace HTTPS; en este caso, añádalo. Para ello, haga clic en el botón Agregar 
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y complete el diálogo que se visualiza con los datos siguientes: tipo del enlace, 
https, puerto, 443, y certificado SSL, en nuestro caso Certificado para pruebas. 
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Ahora ya tenemos un sitio web que admite conexiones HTTPS y también co- 
nexiones HTTP. Esto es, podemos acceder al sitio de cualquiera de las dos formas 
siguientes (si tiene problemas reinicie el sistema): 


http://localhost/WebSite2/Default.aspx 
https://localhost/WebSite2/Default.aspx 


Si quisiéramos requerir que el sitio sea siempre accedido por medio del proto- 
colo HTTPS deberemos configurarlo como veremos a continuación. También, 
cuando accedemos al sitio vía HTTPS, observamos que el navegador nos muestra 
una alerta de seguridad según muestra la figura siguiente. Esto es debido a que la 
autoridad de certificación no es de confianza; en nuestro caso, por tratarse de un 
certificado autofirmado de prueba, no se puede contrastar. Para continuar, haga 
clic en el enlace Vaya a este sitio web (no recomendado). 
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P- O) | Æ Error de certificado: Nav... 








(%] Existe un problema con el certificado de seguridad de este sitio web. 


Este sitio web presentó un certificado de seguridad emitido para una dirección de sitio web diferente. 


Los problemas con los certificados de seguridad pueden indicar un intento de engañarle o de interceptar 
cualquier dato enviado al servidor. 


Le recomendamos que cierre esta página web y no vaya a este sitio web. 
Y Haga clic aquí para cerrar esta página web 


Y Vaya a este sitio web (no recomendado). 


(5) Más información 




















Después de hacer clic en el enlace no recomendado el resultado que obtene- 
mos es el siguiente: 


Usted es el usuario: fjceballos-PC1fjceballos 


La página se ejecuta bajo el contexto de seguridad: 
NT AUTHORITYAServicio de red 


El certificado de cliente se ha omitido. 


Ahora el cliente (por ejemplo, Internet Explorer) se comunica con el servidor 
a través de un canal seguro (comunicación cifrada), pero el servidor no requiere al 
cliente que presente un certificado de cliente y no podemos requerirlo porque, al 
trabajar con un certificado de prueba, no lo tenemos. 


Para requerir al cliente un certificado que lo autentique tendríamos que solici- 
tar a una autoridad de certificación, además del certificado del servidor, un certifi- 
cado de cliente e instalarlo. Evidentemente, el certificado del cliente se instala en 
la máquina que va a ejecutar el navegador para invocar a la aplicación que tene- 
mos instalada en el servidor (en nuestro caso, nuestra máquina es a la vez servidor 
y cliente). Para ello, suponiendo que el navegador es Internet Explorer, tendría 
que abrirlo, ejecutar Herramientas > Opciones de Internet > Contenido > Certifi- 
cados y seguir los pasos indicados. 


Según indicamos anteriormente, podemos configurar un sitio para requerir 
que sea siempre accedido por medio del protocolo HTTPS. Incluso, esta opera- 
ción no hace falta realizarla a nivel del sitio, sino que se puede realizar a nivel de 
una página en particular, por ejemplo a nivel de una página login.aspx. Para reali- 
zar esta configuración, seleccione el nivel que desee para exigir HTTPS y a conti- 
nuación, haga doble clic en el icono Configuración SSL. 
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Después de la acción anterior se le mostrará el panel de configuración de SSL 
para que la modifique según sus necesidades. Cuando finalice, guarde los cambios 
haciendo clic en el enlace Aplicar. 
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En nuestro caso, no podemos requerir el certificado de cliente porque al no 
tenerlo, no podríamos ejecutar la aplicación ASP.NET. Cuando haya terminado, 
pruebe a ejecutar la aplicación y compruebe que solo puede hacerlo vía HTTPS. 
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Certificado de cliente rechazado 


En estos instantes el escenario es el siguiente: un servidor web que alberga un si- 
tio web y que tiene instalado un certificado de servidor, así como el certificado de 
la autoridad de certificación que lo expidió, y una máquina que tiene instalado un 
certificado de cliente, extendido por la misma autoridad de certificación, que será 
utilizado por el cliente web cuando quiera acceder al sitio web. Si trabaja con cer- 
tificados de prueba, caso del ejemplo, al acceder el cliente al sitio web utilizando 
su certificado de cliente, puede encontrarse con el siguiente error: 


HTTP 403.13 - Forbidden: Client certificate revoked 


The page requires a valid client certificate 


Lo que ha ocurrido es que el certificado de cliente es rechazado porque no se 
considera válido, o bien IIS no tiene acceso al servidor que contiene la lista de 
certificados anulados (CRL: Certificate Revocation List) y que le permite verificar 
si el certificado actual es o no uno de ellos. Cuando IIS no tiene acceso a esa lista, 
asume que el certificado es nulo. 


En el caso descrito, para poder continuar con las pruebas debemos deshabili- 
tar la opción que le indica a IIS que haga esa comprobación. La forma más simple 
de hacer esto es abrir una consola del sistema, dirigirse al directorio adminscript 
de inetpub y ejecutar la orden siguiente: 


escript adsutil.css SET w3svc/1/CertCheckMode 1 


Esta orden pone la variable CertCheckMode a 1 (de forma predeterminada va- 
le 0), deshabilitando así la verificación del certificado de cliente contra la CRL. 
La dirección URL de la CRL la proporciona el certificado. Puede comprobarlo. 
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O F.J.Ceballos/RA-MA 


PÁGINAS MAESTRAS 


Una página maestra, denominada también página principal, es una plantilla para 
definir el aspecto de otras páginas, denominadas páginas de contenido, de su sitio 
web. Su contenido serán elementos que se pueden compartir entre varias páginas, 
como controles de inicio de sesión, controles de búsqueda o imágenes, simplifi- 
cando así la tarea de crear una apariencia coherente para su sitio web. 


En general, una página maestra (página .master) puede contener los mismos 
controles que las páginas de contenido (páginas .aspx). También puede contener 
hojas de estilo (CSS) y secuencias de órdenes (scripts) que definen el aspecto ge- 
neral de su sitio. Según sus necesidades, puede construir una o más páginas maes- 
tras (incluso pueden anidarse) para definir el aspecto, el diseño y el 
comportamiento que desea que tengan las páginas de contenido de su sitio web y 
después crear estas páginas de contenido individuales que incluyan la información 
que hay que mostrar. 


ESTRUCTURA DE UNA PÁGINA MAESTRA 


La creación de una página maestra tiene como objetivo dar un aspecto uniforme a 
todas las páginas de un sitio web. Muchos sitios web presentan sus páginas basa- 
das en una estructura clásica de tres columnas con una cabecera. 


Las columnas laterales generalmente están destinadas a albergar los controles 
comunes a todas las páginas de contenido y la columna central proporcionará los 
contenidos específicos para cada página de contenido. La cabecera, que también 
será común a todas las páginas, generalmente contiene el logo del sitio web, la fe- 
cha actual y el menú principal de navegación. 
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Como ejemplo, vamos a crear un sitio web genérico, véase la figura siguiente, 
con la intención de explicar cómo se utilizan las páginas maestras. 





(= = lles) 


NIR x P 
SE nttp://ocalhost/MiSitioWeb/ p- 26 [ 8 localhost x [E] DUE 


(5/0) 





























Mostrar datos 





























K = N 





Para empezar, arranque Visual Studio y cree un nuevo sitio web ASP.NET 
vacío denominado MiSitioWeb (Archivo > Nuevo > Sitio web). 


A continuación, añada una página maestra. Para ello, haga clic con el botón 
secundario del ratón en el nombre del proyecto y seleccione Agregar nuevo ele- 
mento > Página maestra, ponga un nombre a la página maestra, por ejemplo 
MasterPage.master, y haga clic en el botón Aceptar. Esta acción añade una pági- 
na definida por el código siguiente: 


<%@ Master Language="C#" AutoEventWireup="true" 
CodeFile="MasterPage.master.cs" Inherits="MasterPage" %> 
<!DOCTYPE html> 


<html xmlns="http://www.w3.org/1999/xhtml"> 

<head runat="server"> 

<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> 
<title></title> 
<asp:ContentPlaceHolder ID="head" runat="server"> 


</asp:ContentPlaceHolder> 
</head> 
<body> 
<form id="forml" runat="server"> 
<div> 
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<asp:ContentPlaceHolder ID="ContentPlaceHolderl" runat="server"> 


</asp:ContentPlaceHolder> 
</div> 
</form> 
</body> 
</html> 


En el código anterior se observan dos controles de tipo ContentPlaceHolder. 
Se trata de marcadores de posición de contenido reemplazable que actúan como 
contenedores de las páginas que definan a esta como su página maestra. 


Para definir el contenido de los marcadores de posición de contenido reem- 
plazable de la página maestra, cree páginas de contenido individuales y enlácelas 
a la página principal. El enlace se establece en la directiva @ Page de la página de 
contenido al incluir un atributo MasterPageFile que especifica la página principal 
que se va a utilizar. Por ejemplo, añada al proyecto una nueva página .aspx que 
esté enlazada con la página MasterPage.master. Para ello, haga clic con el botón 
secundario del ratón en el nombre del proyecto y seleccione Agregar nuevo ele- 
mento > Formularios Web Forms; ponga un nombre a la página maestra, por 
ejemplo Default.aspx, seleccione la opción Seleccionar página maestra, haga clic 
en el botón Agregar, 





























Agregar nuevo elemento - http://localhost/MiSitioWeb/ [EA] 
4 Instalado Ordenar por: Predeterminado as instalado (Ctrl+E ® ~ 
j A Las ipo: 
ai 6 Formularios Web Forms Visual C# Tipo: Visual C# 
Visual CA ce Formulario para aplicaciones web 
Enea [4] Aplicación auxiliar (Razor) Visual C# 
en 
El Clase de controlador de Web... Visual C# 
s 
en 
El Clase de SignalR Persistent C... Visual C# 
bi 
ce 
2 Clase SignalR Hub Visual Cé 
E 
ca 
@ Página de contenido (Razor) Visual C# 
ce 
@ Página de diseño (Razor) Visual C# 
cs 
@ Página vacía (Razor) Visual C# Y 
Nombre: Default.aspx V| Poner código en archivo independiente 
[Y Seleccionar página maestra 
Agregar j | Cancelar | 




















seleccione la página MasterPage.master y haga clic en el botón Aceptar. 
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Seleccionar una página maestra Lo esa) 


Carpetas de proyecto: Contenido de la carpeta: 


8 http://localhost/MiSitioWeb/ MESSU CUES GI 






































Esta acción añade una página definida por el código siguiente: 


<%@ Page Title="" Language="Cjf" 
="~/MasterPage.master" AutoEventWireup="true' 
CodeFile="Default.aspx.cs" Inherits="_Default" %> 


<asp:Content ID="Content1" 
ContentPlaceHolderlD="head" Runat="Server"> 


</asp:Content> 
<asp:Content ID="Content2" 
ContentPlaceHolderlD="ContentPlaceHolder1l" Runat="Server"> 








</asp:Content> 


Observe que la página de contenido incluye tantos controles Content como 
marcadores de posición de contenido reemplazable hay en la página maestra, cada 
uno de ellos asignado a un determinado marcador. Por ejemplo, la página de con- 
tenido Default.aspx asigna el control Content] al marcador head y Content2 al 
marcador ContentPlaceHolderl. La página que se mostrará al usuario será la fu- 
sión de la página maestra y la página de contenido. En la posición de la página in- 
dicada por head se mostrarán todos los controles definidos en Content! y en la 
posición de la página indicada por ContentPlaceHolderl se mostrarán todos los 
controles definidos en Content2. Todo lo que no esté dentro de los controles Con- 
tent (excepto las secuencias de órdenes) producirá un error. 


A partir de la estructura básica que tenemos, ¿cómo construiríamos un sitio 
web basado en una estructura clásica de tres columnas con una cabecera? Pues lo 
vamos a hacer añadiendo al formulario de la página maestra las capas indicadas a 
continuación: 
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<form id="forml" runat="server"> 
<div id="container"> 
<div id="header"> 
</div> 
<div id="outer"> 
<div id="inner"> 
<div id="left"> 
</div> 
<div id="right"> 
</div> 
<div id="central"> 
<asp:ContentPlaceHolder 
D="ContentPlaceHolder1" runat="server"> 





</asp:ContentPlaceHolder> 
</div> 
</div> 
</div> 
</div> 
</form> 





Hemos añadido una capa principal denominada container que se subdivide en 
otras dos capas, una específica para la cabecera, la capa header, y la otra para el 
resto, outer. Esta última capa a su vez contendrá otra capa, denominada inner, y 
será dentro de esta donde incluyamos las tres capas correspondientes a las tres co- 
lumnas en las que dividiremos la estructura principal de la página: columna de la 
izquierda (left), columna de la derecha (right) y columna central (central). 


A continuación, si lo desea, puede proceder a definir los estilos que van a 
afectar a cada una de estas capas. Por ejemplo, añadimos al proyecto una nueva 
carpeta Estilos y agregamos a esta carpeta un nuevo elemento, Hoja de estilos, 
denominado StyleSheet.css. A continuación, utilizando el editor CSS, puede agre- 
gar los estilos que desee. 


Esquema CSS SETS MasterPage.master StyleSheet.css + X - 
4 D Hoja de estilos 1 body ES 
4 W Elementos 2 jí a 


3 font-size: .80em; 


e 4 font-family: "Arial" , "Lucida Grande" , "Segoe UI” , Helv 
m a:link 5 margin: @px; 
m a:active padding: Opx; 
m a:visited 7 color: #696969; 
m a:hover 8 |} 
m tabs ul 9 
W tabs li 10 Eitcontainer 
m tabs a E 
Micra 12 width: 980px; 
13 padding: Opx; 
E tabs a span 14 margin: 0px; 
m .tabs a:hover span 15 margin-left: auto; 
m tabs a:hover 16 margin-right: auto; 
W tabs a:hover span 17 [} 
4 m Clases 18 


O fecha 19 H#header 
D ¿tabs 2 |i = 


4 m IM da elementos 100% +4 b 
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Una vez creado el fichero StyleSheet.css, puede agregar los estilos que define, 
para ser utilizados en la página maestra, añadiendo en el elemento head de la 
misma, el elemento link siguiente: 


<head runat="server"> 
<link href="=/Estilos/StyleSheet.css" rel="stylesheet" type="text/css"/> 


Una vez agregados los estilos, en los que habremos especificado el ancho de 
las columnas, el diseñador nos mostrará algo similar a la figura siguiente, donde 
puede observar las tres columnas de la división inner: 


Aest) Deaultaz” MasterPagemasterBáginadeiico] -x 


A continuación vamos a describir los elementos situados en la cabecera de la 
página. En primer lugar creamos una tabla con dos filas, la primera con tres co- 
lumnas y la segunda con una, según podemos observar en la figura siguiente: 











Esta tabla la completaremos con los elementos que se observan en la figura 
siguiente: un logo, un título, la fecha y un menú; añádalos ocupando cada uno su 
casilla. El ejercicio resuelto puede obtenerlo de la carpeta Cap19\MiSitioWeb. Pa- 
ra una buena organización, añada al proyecto una nueva carpeta Imagenes para 
guardar las imágenes que vaya a incluir en las páginas; por ejemplo, el logo. 





¿Cómo se implementa el menú? El menú será proporcionado por un control 
de usuario. 


Controles de usuario web 


Los controles de usuario web son componentes ASP.NET que se derivan de la 
clase System.Web.UI.UserControl y tienen extensión .ascx. Estos controles se 
crean como páginas web ASP.NET y una vez creados se pueden incrustar en otras 
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páginas web ASP.NET. Esto es, proporcionan una forma sencilla de crear menús, 
barras de herramientas y otros elementos reutilizables. 


Como ejemplo, vamos a construir el menú de la figura anterior como un con- 
trol de usuario web. Para ello, con el fin de organizar nuestro sitio, vamos a añadir 
al proyecto otra carpeta denominada Controles. Después, haga clic con el botón 
secundario del ratón sobre esta carpeta y agregue un nuevo elemento basado en la 
plantilla Control de usuario web denominado MenuPrincipal: 























Agregar nuevo elemento - http://localhost/MiSitioWeb/ Le k 
4 Instalado Ordenar por: Predeterminado Buscar en la Plantillas instalado (Ctrl+E 4 ~ 
A ce B aei 
Maral Basg El Clase SignalR Hub Visual C# Tipo: Visual C# 
Visual C# z c i ASP.NET 
cs 'ontrol de servidor ASP.NET creado 
D En línea @] Página de contenido (Razor) Visual C# mediante el diseñador visual 
ce 
@ Página de diseño (Razor) Visual C# 
ca 
@] Página vacía (Razor) Visual C# 
ce 
Q Página web (Razor) Visual Cs 
Página maestra Visual C# 
i Control de usuario web Visual C# 
3 ADO.NET Entity Data Model Visual C# v 
Nombre: MenuPrincipal.ascx W| Poner código en archivo independiente 
S onar página maestra 
Agregar | Cancelar | 




















Esta acción añadirá al proyecto, en la carpeta Controles, dos nuevos compo- 
nentes: uno, MenuPrincipal.ascx, para contener los elementos visuales (controles 
HTML, controles de servidor, etc.) y otro, MenuPrincipal.ascx.cs, para contener 
el código, en nuestro caso código C#, que se ejecutará cuando se utilice dicho 
control. 


El componente visual es una página HTML encabezada por la directriz @ 
Control que define los atributos especificos de control de usuario web utilizados 
por el analizador y el compilador de ASP.NET. 


<%@ Control Language="C¿f" AutoEventWireup="true" 
CodeFile="MenuPrincipal.ascx.cs" Inherits="ControlMenuPrincipal"%> 


Y el componente de código subyacente es una clase derivada de UserCon- 
trol, en nuestro caso ControlMenuPrincipal: 


public partial class ControlMenuPrincipal:System.Web.Ul.UserControl 
( 

protected void Page_lLoad(object sender, EventArgs e) 

( 

) 
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Seleccione el componente .ascx, muestre la vista de diseño y arrastre sobre 
ella un control de tipo Literal; se añadirá en el fichero MenuPrincipal.ascx el có- 
digo mostrado a continuación. Este control se utiliza para reservar una ubicación 
en la página web para mostrar el contenido de su propiedad Text. Es similar al 
control Label, excepto en que no permite aplicar un estilo al texto. 


<asp:Literal ID="Literal1" runat="server"></asp:Literal> 


A continuación complete el método Page Load de la clase ControlMenu- 
Principal derivada de UserControl como se indica a continuación: 


protected void Page_load(object sender, EventArgs e) 
( 














string ruta = Request.ApplicationPath; 
string codigo = ""; 
codigo += "<ul>"; 
codigo += "<li><a href=1"" + ruta + 

"/Borrar.aspxW" title=1"Borrar...1"><span>»Borrar</span»</a></11>"; 
codigo += "<li><a href=1"" + ruta + 

"/Añadir.aspxY" title=W"Añadir...1"><span>»Añadir</span></a></11>"; 
codigo += "<li><a href=1"" + ruta + 

"/Default.aspxi" title=1"Mostrar...1"><span»Mostrar</span»</a></11>"; 
codigo += "</ul>"; 
Literall.Text = codigo; 











Este código define una lista no numerada de tres elementos: Mostrar, Añadir 
y Borrar con sus descripciones abreviadas (atributo title). Para mostrar esta lista 
con la apariencia que se mostró en una figura anterior, se requiere definir los esti- 
los correspondientes en la hoja de estilos y añadir las figuras requeridas, elemento 
no seleccionado y seleccionado, en la carpeta que contiene la hoja de estilo. Su- 
poniendo que ya hemos realizado este trabajo, añadimos el control a la página 
maestra así: 


<%@ Master ... Inherits="MasterPage" %> 

<%@ Register Srec="Controles/MenuPrincipal.ascx" 
TagName="MenuPrincipal" TagPrefix="ucl" 

%> 


SETE 
<td colspan="2"> 
<div ElassEntabs"> 
<ucl:MenuPrincipal ID="mp" runat="server" /> 
</div> 
</td> 
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</tr> 


La directriz @ Register crea una asociación entre un prefijo de etiqueta y un 
control personalizado, etiqueta que después utilizaremos para hacer referencia a 
ese control personalizado en un fichero ASP.NET. 


El siguiente paso es añadir las páginas a las que hacen referencia los elemen- 
tos de la lista. El contenido de estas páginas se mostrará en el lugar indicado por 
el marcador de posición de contenido ContentPlaceHolderl. Según observamos 
en el código anterior, la página Default.aspx ya está vinculada con el elemento 
Mostrar del menú. Su aspecto es el siguiente: 


<%@ Page Title="" Language="Cjf" 
MasterPageFile="-=/MasterPage.master" AutoEventWireup="true" 


0 


CodeFile="Default.aspx.cs" Inherits="_Default" %> 


<asp:Content ID="Content1" 
ContentPlaceHolderlD="head" Runat="Server"> 


</asp:Content> 
<asp:Content ID="Content2" 
ContentPlaceHolderlD="ContentPlaceHolderl" Runat="Server"> 

<h2 style="text-align:center; vertical-align">Mostrar datos</h2> 
</asp:Content> 








Como ejemplo, hemos añadido un elemento <hA2> para verificar el compor- 
tamiento de la aplicación. Siguiendo un proceso análogo al que hizo para añadir 
Default.aspx, añada las otras dos páginas: añadir.aspx y borrar.aspx. Después 
ejecute la aplicación y compruebe los resultados. 


A continuación, una vez explicado cómo añadir un control de usuario y ha- 
ciendo uso de lo estudiado en el capítulo Seguridad de aplicaciones ASP.NET, 
añada un control de usuario web que permita a los usuarios que accedan al portal 
autenticarse y registrarse si aún no están registrados. Esto exige establecer la au- 
tenticación mediante formularios. En base a lo expuesto, pasamos a describir los 
pasos fundamentales para añadir este control de usuario: 


1. Añada a la carpeta Controles un nuevo control de usuario web que vamos a 
denominar, por ejemplo, Login; hágalo dentro de una subcarpeta Login. La 
clase subyacente la denominaremos ControlLogin. 


2. Arrastre sobre la superficie de diseño de este control de usuario un control 
LoginView denominado LoginViewl. 
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3. Coloque sobre la plantilla anónima (4nonymousTemplate) de LoginView1 un 
control Login y configúrelo. 


4. Coloque sobre la plantilla autenticado (LoggedInTemplate) de Login Viewl un 
control LoginName y otro LoginStatus y configúrelos. 


5. Añada a la carpeta Controles una nueva página denominada Registro.aspx y 
coloque sobre ella un control CreateUserWizard y configúrelo. 


6. Haga que la página Registro.aspx sea invocada desde el enlace correspondien- 
te de LoginViewl. 


7. Agregue a la carpeta Login un nuevo formulario .aspx, Registro.aspx, que 
muestre un control CreateUserWizard para permitir registrar nuevos usuarios. 
Configure el control Login para que permita acceder a este control. 


8. Habilite la autenticación mediante formularios. 


9. Utilizando el administrador NuGet, añada al proyecto la biblioteca JavaScript 
jQuery. También es necesario añadir el fichero Global.asax, para hacer refe- 
rencia a la ubicación de esta biblioteca en el controlador del evento Start del 
objeto Application. 


Una vez construido, colóquelo en un panel en la capa que define la columna 
izquierda. Para ello, proceda igual que hizo con el menú: 


<%@ Master ... Inherits="MasterPage" %> 


<0 Register Srec="Controles/Login/Login.ascx" 
TagName="Login" TagPrefix="uc2" 
%> 


<div id="left"> 
<asp:Panel ID="Panell" runat="server" BackColor="Lavender"> 
<uc2:Login ID="Login1" runat="server" /> 
</asp:Panel> 
</div> 


Si al control Login no le aplicamos ningún formato, el color de fondo que 
hemos dado al panel se aplicará también al contenido, esto es, al control. 


Una vez hayamos añadido el control Login, cuando inicie la aplicación tendrá 
el aspecto mostrado en la figura de la izquierda, y cuando se autentique, el aspecto 
de la figura de la derecha. 
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| Inicio de sesión | 





Mejorar el aspecto de la interfaz 


La biblioteca Ajax Control Toolkit contiene un conjunto de controles que se pue- 
den utilizar para construir aplicaciones web interactivas habilitadas con AJAX (en 
el siguiente capítulo estudiaremos AJAX) y para mejorar el aspecto de la interfaz. 
Algunos de estos controles son Autocompletar, CollapsiblePanel, ColorPicker, 
MaskedEdit, Calendario, Acordeón o RoundedCornersExtender. Por lo tanto, para 
utilizar estos controles, así como el resto de controles AJAX, hay que instalar, uti- 
lizando el administrador NuGet, esta biblioteca en el proyecto. Una vez instalada 
observará que se ha añadido el fichero AjaxControlToolkit.dll a la carpeta Bin del 
proyecto. 


Como ejemplo, vamos a incluir los controles de las columnas laterales y el 
contenido de la columna central en marcos con las esquinas redondeadas. Por 
ejemplo, vamos a empezar por el control de usuario web Login. Para ello, siga es- 
tos pasos (Login debe ser un control sin formato): 


1. Arrastre un control RoundedCornersExtender sobre la página maestra. Co- 
lóquelo, por ejemplo, encima de la etiqueta de cierre del formulario. Además, 
tendremos que añadir las propiedades que a continuación se muestran som- 
breadas para especificar el control al que se aplicará el redondeo, el radio que 
define dicho redondeo y el color del borde. 


<%@ Register Assembly="AjaxControlToolkit" 
Namespace="AjaxControlToolkit" TagPrefix="asp" %> 


<asp:RoundedCornersExtender 
ID="RoundedCornersExtender1" runat="server" 
TargetControlID="Panel1" Radius="14" BorderColor="DarkGray"> 
</asp:RoundedCornersExtender> 


2. Para poder utilizar los controles de la biblioteca Ajax Control Toolkit es nece- 
sario añadir a la página un control Too!kitScriptManager antes que los contro- 
les que lo requieren. Por lo tanto, arrastre sobre la página maestra un control 
ToolkitScriptManagerl y colóquelo, por ejemplo, debajo de la etiqueta de 
inicio del formulario. 
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<asp:ToolkitScriptManager ID="ToolkitScriptManagerl" 
runat="server"> 
</asp:ToolkitScriptManager> 


Observe ahora el aspecto que toma este control. Aplique, si lo cree convenien- 
te, esquinas redondeadas al resto de las zonas de la página. 


Temas y máscaras en ASP.NET 


Los temas son una colección de valores de atributo o propiedad que permiten de- 
finir el aspecto de las páginas y de los controles de un sitio web. Concretamente, 
un tema (theme) es un grupo de ficheros de máscara, de hojas de estilo, de imáge- 
nes y de otros recursos, como ficheros script o de sonido; un tema debe incluir 
como mínimo una máscara. Aplicando un tema podemos dar un aspecto coherente 
a las páginas de una aplicación web, bien a una sola aplicación web o a todas las 
aplicaciones web de un servidor (tema global). Además tenemos la ventaja de po- 
der administrar los cambios de estilo mediante la realización de cambios en el te- 
ma, sin tener que editar las páginas de forma individual. 


Las máscaras (skins) son ficheros con extensión .skin que contienen los valo- 
res para los atributos o propiedades de los controles individuales (por ejemplo, 
Button, Label, TextBox o Calendar) de una página ASP.NET. Por ejemplo, un 
tema podría incluir una máscara MascaraCalendario para un control Calendar 
que definiera los valores predeterminados para los atributos o propiedades de este 
tipo de controles: 


<asp:Calendar runat="server" SkinID="MascaraClalendario" 
atributos/propiedades de Calendar y sus valores 
</asp:Calendar> 


Si un control, como un TreeView, tiene propiedades cuyos valores se corres- 
ponden con imágenes, estas se pueden incluir como parte del tema. 


Hay máscaras con nombre y máscaras predeterminadas. Las primeras contie- 
nen un atributo SkinID que define el nombre de la máscara, nombre que se utili- 
zará para aplicarla explícitamente a un control, asignando el nombre de la máscara 
a su propiedad SkinID. Y las segundas no contienen un atributo SkinID, por lo 
que se aplicarán a todos los controles del mismo tipo (por ejemplo Label) que no 
especifiquen el atributo SkinID. 


Como ejemplo vamos a añadir a nuestras aplicaciones algunos temas. Para 
ello, haga clic con el botón secundario del ratón sobre el nombre del sitio web y, a 
continuación, haga clic en Agregar carpeta ASP.NET > Tema. Se añadirá la car- 
peta App_Themes y una subcarpeta (que denominaremos, por ejemplo, Gris) para 
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contener el nuevo tema; el nombre de esta carpeta es también el nombre del tema 
de la página. 


A continuación, agregaremos los ficheros que compondrán el tema Gris. Para 
ello, utilizando el botón secundario del ratón, haga clic sobre el nombre del tema 
y seleccione Agregar nuevo elemento > Archivo de máscara. 


En el fichero .skin, agregue las definiciones HTML normales de los controles 
implicados, pero incluyendo únicamente las propiedades que se vayan a establecer 
para el tema. Estas definiciones deben incluir el atributo runat="server" y no de- 
ben incluir el atributo ID (en tal caso, SkinID). Por ejemplo: 


<asp:Panel runat="server" SkinID="MascPanel" BackColor="silver"/> 

<asp:Label runat="server" SkinlD="MascFecha" Forelolor="gray"/> 

<asp: Image runat="server" SkinID = "MascLogo" 
ImageUrl="-=/Imagenes/fjcs-1ogo1l.png"/> 


Siguiendo con el ejemplo, puede añadir otro tema Azul con las siguientes de- 
finiciones: 


<asp:Panel runat="server" SkinID="MascPanel" BackColor="skyblue"/> 

<asp:Label runat="server" SkinID="MascFecha" Forelolor="blue"/> 

<asp: Image runat="server" SkinID = "MascLogo" 
ImageUrl="-=/Imagenes/fjcs-1ogo2.png"/> 


y otro tema Blanco con las siguientes definiciones: 


<asp:Panel runat="server" SkinID="MascPanel" BackColor="white"/> 

<asp:Label runat="server" SkinID="MascFecha" ForeClolor="silver"/> 

<asp: Image runat="server" SkinID = "MascLogo" 
ImageUrl="-=/Imagenes/fjcs-1ogo3.png"/> 


Ahora habrá que añadir la propiedad SkinID a los controles de las páginas 
afectados por un tema. Por ejemplo, en la página maestra: 


<asp:Panel ID="Panell" runat="server" SkinID="MascPanel"> 


<ucz2:Login ID="Login1" runat="server" /> 
</asp:Panel> 


También puede agregar una hoja de estilos al tema de la página. Para ello, ha- 
ga clic con el botón secundario del ratón en el nombre del tema y, a continuación, 
haga clic en Agregar nuevo elemento > Hoja de estilos. 


Normalmente, un tema se aplica a una página o a un sitio web. También po- 
demos aplicar un tema al sitio web y otro tema en particular a una página. 
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Para aplicar un tema a un sitio web, agregue al fichero Web.config el elemen- 
to <pages> con el nombre del tema, ya sea este global o de página, como se 
muestra en el siguiente ejemplo: 


<configuration> 
<system.web> 
<pages theme="NombreTema"> 
</pages> 
</system.web> 
</configuration> 


Para aplicar un tema a una página individual, establezca el atributo Theme de 
la directriz @ Page con el nombre del tema: 


<%@ Page Theme="NombreTema" %> 


También, para aplicar un tema únicamente a un subconjunto de páginas, po- 
demos colocar estas en una carpeta con su propio fichero Web.config o bien crear 
en este un elemento </location> para especificar una carpeta. 


Ahora, si ejecuta la aplicación observará cómo se aplican los temas. Como 
ejemplo, observe la etiqueta que muestra la fecha: 


<div class="fecha”> 
<asp:Label ID="etFecha" runat="server" SkinID="MascrFecha"/> 
</div> 


La etiqueta etFecha tiene aplicado el estilo fecha y la máscara MascFecha. En 
este caso, se aplica el estilo y después la máscara, estableciendo finalmente el co- 
lor especificado por esta. 


El tema también podría especificarse desde el código, ya que cada página tie- 
ne una propiedad Theme que permite establecer el nombre del tema utilizado para 
dicha página. El tema especificado debe existir como tema global o del sitio. Esto 
debe hacerse desde el evento Prelnit, instante en el que la página (según su ciclo 
de vida) obtiene el tema a utilizar. Por ejemplo: 


protected void Page _Prelnit(object sender, EventArgs e) 
( 
Page.Theme = temaPredeterminado; // tema predeterminado 


} 


El tema predeterminado podría definirse en el fichero Web. config así: 


<configuration> 
<appSettings> 
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<add key="temaPredeterminado" value="Blanco"/> 
</appSettings> 
</configuration> 


y después, obtenerlo así: 


protected void Page_Prelnit(object sender, EventArgs e) 
( 


Page.Theme = ConfigurationManager. 
AppSettings["temaPredeterminado"].ToString(); 


Perfiles 


Otra alternativa sería utilizar perfiles. Los perfiles permiten administrar la infor- 
mación de un usuario sin que sea necesario crear y mantener su propia base de da- 
tos, ya que los perfiles se almacenan en la base de datos aspnetdb.mdf creada por 
ASP.NET para la administración de usuarios. Para poder utilizar perfiles tendre- 
mos que habilitarlos modificando el fichero Web.config como se indica a conti- 
nuación y para almacenar y recuperar datos de la base de datos se utilizará, por 
omisión, el proveedor de perfiles incluido con .NET Framework AspNetSqlProvi- 
der. Una vez habilitados, se define la lista de propiedades cuyos valores se desea 
mantener, Estas propiedades serán almacenadas en una tabla aspnet Profile de la 
base de datos para unirse así al resto de propiedades, como el nombre y la contra- 
seña del usuario, definidas en otra tabla de la misma base. Por ejemplo, en nuestro 
caso deseamos almacenar el tema predeterminado para que la aplicación pueda fi- 
jarlo cuando se inicie. Para ello, definiremos una propiedad de perfil denominada 
temaPredeterminado a la que asignaremos el valor Blanco: 


<system.web> 
<profile> 
<properties> 
<add name="temaPredeterminado" 
defaultValue="Blanco" type="String"/> 
</properties> 
</profile> 
<system.web> 


Cuando se ejecuta la aplicación, estando habilitados los perfiles, ASP.NET 
crea un objeto de la clase ProfileCommon (clase generada dinámicamente), que 
hereda la clase ProfileBase, que incluye, además de un conjunto de propiedades 
predefinidas como el nombre del usuario que se autenticó, las propiedades de per- 
fil especificadas en la configuración de la aplicación. Dicho objeto queda referen- 
ciado por la propiedad Profile del objeto HttpContext actual, que está disponible 
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para todas las páginas de la aplicación. Según esto, para obtener el valor de una de 
sus propiedades, desde cualquier página de contenido, ya que una página maestra 
no tiene la propiedad Theme, procederemos así: 


protected void Page_Prelnit(object sender, EventArgs e) 
( 
System.Web.Profile.ProfileBase perfil = 
new System.Web.Profile.ProfileBase(); 
perfil = HttpContext.Current.Profile; 
Page.Theme = 
perfil.GetPropertyValue("temaPredeterminado").ToString(); 


Como una página maestra no tiene una propiedad Theme que pueda extender 
a las páginas de contenido vinculadas con ella, lo que podemos hacer para no te- 
ner que repetir el proceso explicado para todas las páginas de contenido que 
deseemos de nuestro sitio web es definir una clase base derivada de Page, por 
ejemplo PaginaBase, que implemente la funcionalidad para establecer el tema 
predeterminado y después derivar de esta clase cada clase de página a la que 
deseemos aplicar el tema. Esta clase podría ser así: 


public class PaginaBase : System.Web.Ul.Page 
( 
public PaginaBase() [ ) 


protected void Page_Prelnit(object sender, EventArgs e) 
( 
System.Web.Profile.ProfileBase perfil = 
new System.Web.Profile.ProfileBase(); 
perfil = HttpContext.Current.Profile; 
Theme = 
perfil.GetPropertyValue("temaPredeterminado").ToString(); 


Y a continuación, hacemos que todas las páginas que vayan a utilizar el tema 
definido hereden de esta. Por ejemplo, para la página Default sería así: 


public partial class _Default : PaginaBase 
( 

1/ 
) 


Proceda de igual forma para las páginas Añadir y Borrar. 


Y cuando disponemos de varios temas, ¿cómo permitimos al usuario elegir su 
tema? Esto podemos hacerlo cuando el usuario esté autenticado. A partir de este 
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instante, le permitiremos que elija el tema que más le guste de los predefinidos y 
quedará guardado en el perfil para la próxima vez que se autentique. Para ello, 
vamos a modificar la plantilla autenticado (LoggedInTemplate) de LoginViewl 
para que además de mostrar los controles LoginName y LoginStatus, muestre el 
resto de los controles (una etiqueta, una lista desplegable que muestre los temas y 
un botón para aplicar el nuevo tema) que puede ver en la figura siguiente: 





Una vez añadidos los controles indicados, observará un código HTML análo- 
go al siguiente: 


<asp:Label ID="Label1" runat="server" Text="Tema: "></asp:Label> 

<asp:DropDownList ID="DropDownListl1" runat="server"> 

</asp:DropDownList> 

<br /><br /> 

<asp:Button ID="Button1" runat="server" OnClick="CambiarTema" 
Text="Aceptar" /><br /><br /> 


Pensemos cómo suceden los hechos. El usuario ejecuta la aplicación, se le 
muestra el formulario, se autentica y se vuelve a cargar el formulario mostrando 
ahora el control de usuario web de la figura anterior. Pues bien, interceptaremos el 
evento Load, que se generó cuando el control de servidor se cargó en el formula- 
rio una vez autenticado el usuario, para cargar la lista desplegable con los temas 
de la aplicación. Para ello, puesto que los eventos de los controles ASP.NET si- 
guen, igual que las páginas, el modelo estándar de NET Framework para los con- 
troladores de eventos, añada a la clase ControlLogin el método indicado a 
continuación: 


protected void Page_load(object sender, EventArgs e) 
{ 
if (!IsPostBack && 
HttpContext.Current.User.Identity.IsAuthenticated) 
{ 
// Cargar la lista desplegable con los temas 
string[] nombreTema = ObtenerTemas(); 
DropDownList DropDownListl = 
(DropDownList)LoginViewl.FindControl("DropDownList1l"); 
DropDownListl.DataSource = nombreTema; 
DropDownListl.DataBind(); 
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DropDownListl.SelectedValue = Profile.temaPredeterminado; 
) 
) 


private stringl] ObtenerTemas() 
( 
string[] nombreTema; 
Directorylnfo directorio; 
// Recuperar las rutas de todos los temas 
nombreTema = 
Directory.GetDirectories(Server.MapPath("App_Themes")); 


for (int i = 0; i < nombrelema.Length; i++) 

{ 
directorio = new DirectoryInfo(nombreTema[i]); 
// Guardar solo el nombre del tema (coincide con la carpeta) 
nombreTema[i] = directorio.Name; 

) 

return nombreTema; 


Este método obtiene las rutas de todas las carpetas correspondientes a los te- 
mas (subdirectorios de App Themes) y almacena el nombre de las mismas en la 
matriz nombreTema. Después vincula esta matriz con la lista DropDownList] pa- 
ra que muestre los temas. Esto solo se hace cuando no se trata de un postback y el 
usuario se autenticó correctamente. 


Una vez que el usuario se autenticó, podrá seleccionar de la lista el tema que 
desee, y, para fijarlo, hará clic en el botón Aceptar. Esta acción genera el evento 
Click del botón, que interceptaremos para actualizar el perfil de este usuario con 
el nuevo tema seleccionado. Entonces, la aplicación debe recopilar el valor que se 
desea almacenar y asignárselo a la propiedad de perfil temaPredeterminado que 
definimos. En nuestro ejemplo, la página principal de la aplicación incluye un 
control de usuario que contiene un control LoginView]l que tiene dentro una lista 
desplegable, DropDownListl, que permite al usuario seleccionar un tema. Cuando 
el usuario selecciona el tema y hace clic en el botón Aceptar, se establece una 
propiedad Profile para almacenar el valor correspondiente al usuario actual, como 
muestra la línea de código siguiente: 


Profile.temaPredeterminado = DropDownList1.SelectedValue; 


Cuando se establece un valor para Profile.temaPredeterminado, dicho valor 
se almacena automáticamente para el usuario actual. No es necesario escribir nin- 
gún código para determinar quién es este usuario o almacenar de forma explícita 
el valor en una base de datos (estas tareas ya las realiza automáticamente el pro- 
veedor de perfiles). Según lo expuesto, añada a la clase del control de usuario 
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web, ControlLogin, el controlador para el evento clic del botón y complételo co- 
mo se indica a continuación: 


protected void CambiarTemal(object sender, EventArgs e) 
( 
DropDownList DropDownListl = 
(DropDownList)LoginView1.FindControl("DropDownList1"); 
Profile.temaPredeterminado = DropDownListl.SelectedValue; 
Profile.Save(); 
Server.Transfer(Request.FilePath); 





Para actualizar el perfil en el origen de datos con los valores de las propieda- 
des que cambiaron, hay que invocar al método Save. Todos estos cambios serán 
guardados en la tabla correspondiente de la base de datos aspnretdb.mdf adminis- 
trada por el proveedor de perfiles incluido con .NET Framework. 


Finalmente, hay que indicar que si los usuarios que pueden acceder a la apli- 
cación pertenecen a distintos perfiles (por ejemplo, usuarios autenticados o admi- 
nistradores), cuando se inicie la aplicación podríamos habilitar o inhabilitar 
distintos controles según el perfil. Por ejemplo, suponiendo que el Panel4 solo es 
para el perfil administradores, podríamos habilitarlo o no, en respuesta al evento 
Load de la página maestra, así: 


Panel4.Visible = 
HttpContext.Current.User.IsInRole("Administradores"); 


EJERCICIOS RESUELTOS 


Vamos a crear un sitio web para administrar una base de datos de teléfonos de uso 
frecuente. El sitio mostrará cuatro páginas: una para mostrar la lista de teléfonos, 
otra para permitir al usuario añadir nuevos teléfonos, una tercera para permitir al 
usuario eliminar teléfonos y una cuarta para mostrar información acerca de la 
aplicación, todas vinculadas a una página maestra. Para acceder a las páginas de 
añadir y eliminar teléfonos del sitio web, el usuario tendrá que autenticarse. Sólo 
los usuarios del grupo “administradores” podrán borrar teléfonos. La página para 
mostrar los teléfonos podrá ser vista por cualquier usuario y será la que se visuali- 
ce al iniciar la aplicación. 


La página maestra proporcionará un título, un enlace para iniciar o cerrar una 
sesión, un menú con las opciones Inicio, Añadir, Borrar y Acerca de... y el mar- 
cador de posición de contenido reemplazable para las páginas de contenido co- 
rrespondientes a cada una de las opciones del menú. 
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Los datos correspondientes a los perfiles de los usuarios serán gestionados de 
forma automática por el proveedor de perfiles predeterminado de .NET y los datos 
correspondientes a cada teléfono de la lista estarán almacenados en una base de 
datos telefonos. El acceso a la base de datos se hará a través de un servicio web 
que mostrará una interfaz programática formada por dos métodos: Aña- 
dir telefono y Borrar _telefono. 
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Registrarse Iniciar sesión 


Inicio Acerca de 


Página de inicio. Lista de teléfonos: 














Nombre Dirección Teléfono Observaciones 

Francisco Ceballos Fernández Boston, U.S.A. 111555999 CEO Evermedia 

Isabella Ceballos González Boston, U.S.A. 123456789 La más grande 

Javier Ceballos Fernández Alcalá de Henares, Madrid 911234567 Ingeniero de Informática 

Roberto Canales Mora Torrejón, Madrid 916753306 Director ejecutivo de Autentia 

Pedro Aguado Rodríguez Alcalá de Henares, Madrid 918888888 Ninguna 

Alfons González Pérez Argentona, Barcelona 933333333 Director de desarrollo 

Ismael Puertas López Mataró, Barcelona 934343567 Frabicante de calzado 

Miguel López Trujillo Mataporquera, Cantabria 942232323 Es propietario de la empresa PUBLICSA bá 











Según lo expuesto, primero construiremos la base de datos, después creare- 
mos el servicio web y, finalmente, crearemos una aplicación ASP.NET, cliente 
del servicio, para que utilizando este servicio pueda añadir un registro a la base, o 
bien eliminarlo, y mostrar en una tabla los datos actualmente almacenados en la 
base. 


Base de datos 


La base de datos estará formada por una tabla telefonos y la denominaremos 
bd telefonos. Cada fila de la tabla estará formada por los campos: 


nombre VARCHAR(30) NOT NULL, 
direccion VARCHAR(30) NOT NULL, 
telefono VARCHAR(12) PRIMARY KEY NOT NULL, 





observaciones VARCHAR(240) 


Para crear la base de datos lo haremos según se explicó en el capítulo Acceso a 
una base de datos. No olvide dar permisos al usuario NT AUTHORITY Servicio de 
Red para que pueda acceder a esta base de datos. 
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Vamos a comprobar que podemos acceder a la base de datos. Diríjase al Ex- 
plorador de servidores (si no está visible, ejecute la orden Ver > Explorador de 
servidores) y haga clic en el botón Conectar con la base de datos. Complete el 
formulario que se muestra como se indica en la figura siguiente: 


r G àl 
Agregar conexión 0 ies 


Especifique la información para establecer conexión con el origen de datos 
seleccionado o haga dlic en "Cambiar" para elegir un origen y/o un 
proveedor de datos diferente. 








Origen de datos: 
Microsoft SQL Server (SqlClient) Cambiar... 


Nombre del servidor: 


Asqlexpress X Actualizar 
Conexión con el servidor 


(9) Usar autenticación de Windows 


© Usar autenticación de SQL Server 


Guardar mi contraseña 


Establecer conexión con una base de datos 


®© Seleccione o escriba el nombre de la base de datos: 


bd_telefonos X 


D Asociar con un archivo de base de datos: 


Avanzadas... 
ri) nor] 


























Una vez probada la conexión (clic en el botón Probar conexión), si el resulta- 
do fue satisfactorio, haga clic en Aceptar. Observará en el Explorador de servido- 
res que se ha añadido una conexión con la base de datos especificada. Para ver el 
contenido de la base y de la tabla telefonos, expanda el nodo tablas, haga clic con 
el botón secundario del ratón sobre el nodo telefonos y ejecute la orden Mostrar 
datos de la tabla. 
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Explorador de servidores Y AX 
(e) * ss E 
4 gl Conexiones de datos 5 


4 E fceballos-pasqlexpress.bd_telefonos.dbo 
4 ml Tablas 


4 telefonos 


B nombre 
B direccion 
"o telefono 
B observaciones 
E Vistas 
El Procedimientos almacenados 


El Sinónimos 
ml Tipos 


b 
b 
> E Funciones 
b 
b 
> ml Ensamblados 


v 


Explorador de sol... Vista de clases Explorador de ser... 


La base de datos bd telefonos ha sido ubicada en la carpeta Data de la insta- 
lación de Microsoft SOL Server. Otra alternativa sería crearla directamente desde 
el EDI: clic con el botón secundario del ratón sobre el nombre del proyecto en el 
explorador de soluciones, Agregar nuevo elemento > Base de datos SOL. Des- 
pués, añadiríamos la tabla o tablas desde el Explorador de bases de datos: clic con 
el botón secundario del ratón sobre el nodo Tablas. ¿Por qué no hemos procedido 
de esta forma? Porque la base de datos, según el planteamiento que hemos hecho, 
va a ser accedida tanto desde el servicio web como desde la aplicación ASP.NET, 
lo que no supone ningún problema si ubicamos la base en la carpeta predetermi- 
nada por Microsoft SOL Server. 


El paso siguiente es crear el servicio web. Lo denominaremos ServWebTfnos. 
Para ello, inicie Visual Studio y cree un nuevo servicio web ubicado en HTTP uti- 
lizando la plantilla Servicio WCF. Se crea el servicio Service.svc. A continuación, 
añadimos dos métodos al servicio web: Añadir telefono y Borrar_telefono. 


[ServiceContract] 
public interface IService 
( 
[OperationContract] 
void Añadir_telefono(string nom, string dir, string tel, string obs); 


[OperationContract] 
void Borrar_telefono(string tel); 





public class Service : IService 
( 

// Definición de los métodos para añadir y borrar 
) 
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En el capítulo Acceso a una base de datos vimos distintos mecanismos para 
acceder a los datos de una base de datos; desde utilizar, junto con los componen- 
tes que conforman un proveedor de datos, sentencias SQL escritas directamente 
en la lógica de negocio, procedimientos almacenados, etc., hasta utilizar el len- 
guaje de consulta integrado LINQ con ADO.NET Entity Framework, todo ello 
expuesto en el capítulo LINO. Como en el capitulo Servicios web ya vimos cómo 
acceder a una base de datos desde un servicio web utilizando ADO.NET Entity 
Framework, en el ejercicio que estamos realizando ahora vamos a utilizar senten- 
cias SQL escritas directamente en la lógica de negocio como otra alternativa. 


El método Añadir_telefono abre una conexión con la base de datos, ejecuta la 
orden SQL INSERT, que hemos construido con los parámetros pasados como ar- 
gumentos al método, con el fin de insertar una nueva fila en la base de datos y fi- 
naliza cerrando la conexión. 


public void Añadir_telefono(string nom, string dir, 
string tel, string obs) 

( 

// Añadir un registro de la base de datos (BD) 

// Conexión 

// TocalhostiAsqlexpress? 

string cadenaDeConexión = "server=localhostiAsqlexpress;" + 
"database=bd_telefonos;Trusted_Connection=yes"'; 
SqllConnection conexión = new SqlConnectionícadenaDeConexión); 


// Orden SQL 

string sOrdenSQL = 
"INSERT INTO telefonos(nombre, direccion, telefono, observaciones) "+ 
"VALUESCONOMBRE, CDIRECCION, ETELEFONO, EOBSERVACIONES)"; 





SqllCommand ordenSQL = new SqlCommand(sOrdenSQL, conexión); 
ordenSQL.Parameters.AddWithValue("ENOMBRE", nom); 
ordenSQL.Parameters.AddWithValue("EDIRECCION", dir); 
ordenSQL.Parameters.AddWithValue("ETELEFONO", tel); 
ordenSQL.Parameters.AddWithValue("EOBSERVACIONES", obs); 











// Abrir una conexión con BD, ejecutar la orden SOL 
// y cerrar la conexió 
ordenSQL.Connection.Open(); 
ordenSQL.ExecuteNonQuery(); 
ordenSQL.Connection.Close(); 








El método Borrar_telefono abre una conexión con la base de datos, ejecuta la 
orden SQL DELETE, que hemos construido con el parámetro pasado como argu- 
mento al método, con el fin de borrar la fila que contenga en el campo telefono el 
valor del parámetro, y finaliza cerrando la conexión. 
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public void Borrar_telefono(string tel) 
( 

// Borrar un registro de la base de datos (BD) 

// Conexión 

string cadenaDeConexión = "server=localhostiAsqlexpress;"+ 
"database=bd_telefonos;Trusted_Connection=yes"'; 
SqllConnection conexión = new SqlConnectioní(cadenaDeConexión); 


// Orden SOL 
string sOrdenSQL = "DELETE FROM telefonos " + 
"WHERE telefono = TELEFONO"; 





SqlCommand ordenSQL = new SqlCommand(sOrdenSQL, conexión); 
ordenSQL.Parameters.AddWithValue("ETELEFONO", tel); 

// Abrir una conexión con BD, ejecutar la orden SQL y 

// cerrar la conexión 

ordenSQL.Connection.Open(); 

ordenSQL.ExecuteNonQuery(); 

ordenSQL.Connection.Closeí); 


S1 el proyecto no contiene un fichero de configuración, añádalo. Asegúrese de 
que el modo de autenticación es Anónimo. A efectos de depuración (F5), abra este 
fichero y asigne al atributo debug de compilation el valor true; y a efectos de 
ejecución de la aplicación en producción vuelva a ponerlo a false. 


Compile el servicio web y ejecútelo pulsando las teclas Ctrl +F5. Pruebe los 
métodos Añadir telefono y Borrar telefono. Después de cada operación, observe 
el contenido de la tabla telefonos para verificar que los métodos trabajan correc- 
tamente. 


Cliente web 


El siguiente objetivo es construir una aplicación ASP.NET que actúe como cliente 
del servicio web. Esta aplicación mostrará una página web que visualizará una ta- 
bla con el contenido de la tabla telefonos de la base de datos. Esta página, más las 
páginas para añadir y eliminar un teléfono y la página Acerca de, estarán basadas 
en una página maestra que aporte, básicamente, el título de la aplicación, un enla- 
ce para iniciar o cerrar una sesión y un menú con las opciones /nicio, Añadir, Bo- 
rrar y Acerca de... La autenticación será mediante formularios. La estructura 
hasta aquí descrita puede ser creada automáticamente por Visual Studio si crea un 
nuevo sitio web, MiApTfnos, utilizando la plantilla Sitio de ASP.NET Web Forms. 
El resultado sería este: 
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a 


2) 
A 








We suggest the following: 





© |- http://localhost/MiApTfnos/Default.aspx 





Registrarse Iniciar sesión 


Inicio Acercade Contacto 
Home Page. Modify this template to jump-start your ASP.NET 
application. 


Getting Started 
ASP.NET Web Forms lets you build dynamic websites using a familiar drag-and-drop, event-driven model. A design surface and 
hundreds of controls and components let you rapidly build sophisticated, powerful Ul-driven sites with data access. Learn more... 


Add NuGet packages and jump-start your coding 
NuGet makes it easy to install and update free libraries and tools. Learn more... 


Find Web Hosting 























Ejecute la aplicación y observe que puede registrarse, iniciar sesión, navegar 
entre las páginas Inicio, Acerca de, etc. Por lo tanto, solo queda personalizar la 


aplica 
les de 


ción, agregar las páginas para añadir y borrar un teléfono y definir los perfi- 
usuario para indicar quiénes pueden acceder a qué páginas. 


Cuando haga clic en Iniciar sesión se mostrará la ventana siguiente: 
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P-a I l- Iniciar sesión - Mi aplica... | | w ? 





/MiApTfnos, 








Registrarse Iniciar sesión 


Inicio Acerca de 


Iniciar sesión. 


Utilice una cuenta local para iniciar 
sesión. 


Nombre de usuario 


Contraseña 











¿Recordar cuenta? 








Iniciar sesión 











Registrarse si no tiene una cuenta. v 




















y si hace clic en el enlace Registrarse de la ventana anterior, se mostrará la venta- 
na siguiente: 























r y 
Loeks 


a l- http://localhost/MiAp 


105/Account/Register p-a e| |- Registrarse - Mi aplicaci... | uu 








A 
Registrarse Iniciar sesión 


Inicio Acerca de 


Registrarse. Use el formulario siguiente para crear una cuenta nueva. 





Es necesario que las contraseñas tengan al menos 6 caracteres. 











Nombre de usuario 


Dirección de correo electrónico 


Contraseña 


Confirmar contraseña 





Registrarse 
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Edite la página maestra, Site.master, elimine el elemento Contacto del menú 
de navegación y elimine del proyecto la página web correspondiente. 


<nav> 
<ul id="menu"> 
<li><a runat="server" href="-=/">Inicio</a></11> 
<li><a runat="server" href="-/About">Acerca de</a></1i> 
</ul> 
</nav> 


El elemento <nav> representa una sección de un documento que contiene en- 
laces de navegación a otros documentos o lugares dentro del documento. 


Personalice la página About.aspx para que pueda mostrar información acerca 
de la aplicación. 





r 


























y J 
[E pm 
O l- http://localhost/MiApTfnos/About A~ BÈ ||- Acerca de - Mi aplicació... * | ] w E 
A 
Registrarse Iniciar sesión 
Inicio Acerca de 
. z ee 
Acerca de mi aplicación ASP.NET. 
Todos los usuarios pueden ver la lista de teléfonos. Menú 
Sólo los usuarios autenticados pueden añadir teléfonos. r EN 
Sólo los usuarios autenticados que pertenezcan al grupo de "administradores" pueden borrar fido 
teléfonos. ETR 
Acerca de 
© 2013 - Mi aplicación ASP.NET 
v 
E 














Esta página, para mostrar el menú adicional utiliza un elemento <aside>. 


<aside> 
<h3>Menú</h3> 
<p> 
Menú adicional. 
</p> 
<ul> 
<li><a runat="server" href="-=/">Inicio</a></11> 
<li><a runat="server" href="-/About">Acerca de</a></11> 
</ul> 
</aside> 
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Lo siguiente que vamos a hacer es diseñar la página de inicio, Default.aspx, 
para que muestre la lista de teléfonos. Para ello, diríjase al Explorador de base de 
datos y abra una conexión con la base de datos bd telefonos. Después, arrastre 
desde el Explorador de servidores la tabla telefonos. Observará, según muestra la 
figura siguiente, que automáticamente se genera sobre la página una tabla con un 
número de columnas igual al de la tabla telefonos. 


Si ahora compila y ejecuta la aplicación, observará los resultados mostrados 
en la figura siguiente; si no fuera así, configure el objeto SqlDataSource que se 
añadió cuando arrastró la tabla. 














http://localhost/MiApTínos/Default.aspx Ppr- Ed | l Página de inicio - Mi ap... * | | 









Registrarse Iniciar sesión 


Inicio Acerca de 


Página de inicio. Lista de teléfonos: 


Nombre Dirección Teléfono Observaciones 

Francisco Ceballos Fernández Boston, U.S.A. 111555999 CEO Evermedia 

Isabella Ceballos González Boston, U.S.A. 123456789 La más grande 

Javier Ceballos Fernández Alcalá de Henares, Madrid 911234567 Ingeniero de Informática 

Roberto Canales Mora Torrejón, Madrid 916753306 Director ejecutivo de Autentia 

Pedro Aguado Rodríguez Alcalá de Henares, Madrid 918888888 Ninguna 

Alfons González Pérez Argentona, Barcelona 933333333 Director de desarrollo 

Ismael Puertas López Mataró, Barcelona 934343567 Frabicante de calzado 

Miguel López Trujillo Mataporquera, Cantabria 942232323 Es propietario de la empresa PUBLICSA 54 




















Nos queda utilizar los recursos proporcionados por el servicio web Serv- 
WebTfnos para añadir o eliminar teléfonos de la base de datos. Añadir un registro 
a la base de datos supone pedirle al usuario los datos nombre, dirección, teléfono 
y observaciones que lo forman, lo haremos mediante una nueva página web de- 
nominada Añadir.aspx; y eliminar un registro de la base de datos supone solicitar- 
le al usuario el teléfono (clave principal) que forma parte del registro que se desea 
eliminar, lo haremos mediante una nueva página web denominada Borrar.aspx. 
Según lo expuesto, y con el fin de facilitar la autorización, añada dos carpetas al 
proyecto, Añadir y Borrar, y esas dos páginas, cada una en su carpeta respectiva, 
vinculadas con la página maestra. 


Ahora ya tenemos cuatro páginas: Default.aspx, Añadir.aspx, Borrar.aspx y 
About.aspx. Para movernos desde cualquiera de las páginas a otra, utilizaremos el 
menú proporcionado por la página maestra: 


<nav> 
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<ul id="menu"> 
<li><a runat="server" href="-=/">Inicio</a></11> 


<li><a runat="server" href="-/Añadir/Añadir.aspx">Añadir</a></11 
<li><a runat="server" href="-/Borrar/Borrar.aspx">Borrar</a></11 


<li><a runat="server" href="-/About">Acerca de</a>»</11> 
</ul> 


</nav> 


ta 


> 
> 


A continuación, completamos la página Añadir.aspx con los controles que 
puede observar en la figura siguiente: cuatro etiquetas, cuatro cajas de texto (la de 
observaciones multilinea), un botón y los controles de validación para requerir el 
nombre, la dirección y el teléfono (la aplicación completa puede verla en la carpe- 


Cap19\MiApTfnos). 





r 








GuES 














1- http://localhost/MiApTinos/A%C3%B 1adir/A%C3%BLadirs P + ®© || |- Página añadir - Mi aplic.. *| | ID 








Registrarse Iniciar sesión A 


Inicio Añadir Borrar Acerca de 


Página añadir teléfono. 





Use el formulario siguiente para añadir un nuevo teléfono. 


Los campos nombre, dirección y teléfono son obligatorios. 





Nombre: 

Nombre requerido. 
Dirección: 

Dirección requerida. 
Teléfono: 


Número de teléfono requerido. 


Observaciones: 


Añadir v 

















d 





Cuando el usuario quiera registrar un teléfono en la base de datos, hará clic en 
la opción Añadir del menú, si es que esta página no se está visualizando, introdu- 
cirá los datos en las cajas de texto y hará clic en el botón Añadir. Según este plan- 
teamiento, el controlador de este botón lo único que tiene que hacer es invocar al 
método Añadir _telefono del servicio web. 
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Para que la aplicación ASP.NET pueda acceder al servicio web hay que aña- 
dir a la misma una referencia web a dicho servicio. Para ello, diríjase al explora- 
dor de soluciones, haga clic con el botón secundario del ratón sobre el nombre del 
proyecto y ejecute la orden Agregar referencia de servicio. En la ventana que se 
muestra, escriba la dirección donde se localiza el servicio ServWebTfnos. Una vez 
localizado, asigne un nombre a la referencia, según puede observarse en la figura 


siguiente, y haga clic en el botón Aceptar. 





i 
Agregar referencia de servicio 


Le E) 





Dirección: 


http://localhost/ServWebTfnos/Service.svc 


Para ver una lista de servicios disponibles en un servidor específico, escriba una dirección URL de servicio y 
haga clic en Ir. Para buscar servicios disponibles, haga clic en Detectar. 


Operaciones: 

















Espacio de nombres: 


refServicioTfnos 


| Avanzadas... 





O Añadir_telefono 


O Borrar_telefono 


1 servicios encontrados en la dirección 'http://localhost/ServWebTfnos/Service.svc.. 





[ Aceptar | Cancelar 

















Según lo expuesto, el controlador del botón Enviar de la página web Aña- 


dir.aspx tiene que recuperar los datos de 


las cajas de texto e invocar al método 


Añadir_telefono del servicio web pasando como argumentos estos datos: 


protected void btAñadir_Click(object sender, EventArgs e) 


( 


// Recuperar los datos de la pági 


string nombre ctNombre.Text; 
string dirección 
string teléfono 
string observaciones 
// Añadir el 


refServi 








na web 


ctDireccion.Text; 
ctTelefono.Text; 
ctObservaciones.Text; 
registro correspondi 
cioTfnos.ServiceClient proxy 
new refServiciolfnos.ServiceCli 


ente a la base de datos 


ent(); 


proxy.Añadir_telefono(nombre, dirección, teléfono, observaciones); 
Response.Redirect("../Default.aspx"); 
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El objeto proxy es una representación local de un objeto de la clase del servi- 
cio (clase Service) accedida a través de la referencia refServicioTfnos. Este objeto 
lo utilizaremos para acceder a los métodos del servicio web. 


El objeto Response encapsula la información de la respuesta HTTP como re- 
sultado de una petición realizada a una aplicación ASP.NET. Su método Redirect 
redirige al cliente a la nueva dirección URL especificada. 


En el enunciado decíamos que esta página solo podría ser accedida por usua- 
rios autenticados. Para ello, añada a la carpeta Añadir un fichero Web.config con 
el código siguiente: 


<system.web> 
<authorization> 
<deny users="2"/> 
</authorization> 
</system.web> 


Estos ficheros de configuración pueden construirse desde la herramienta de 
administración de sitios web que vimos en el capítulo Seguridad de aplicaciones 
ASP.NET. 


Con el fin de atrapar estos errores, como añadir un teléfono ya existente en la 
base de datos, y permitir al usuario volver a la página de inicio, añada a la clase 
que define la página Añadir.aspx el método indicado a continuación: 


protected void Page_Error(object sender, EventArgs e) 
( 
Exception objError = Server.GetLastError().GetBaseException(); 


string mensajeError = "<h3>Error: </h3><hr><br>" + 
objError.Message.ToString() + 
"<br><br><a href="../Default.aspx*>Volver</a>"; 
Response.Write(mensajeError.ToString()); 
Server.ClearError(); 


Finalmente, completamos la página Borrar.aspx con los controles que puede 
observar en la figura siguiente: una etiqueta, una caja de texto, un botón y un con- 
trol de validación para requerir el teléfono. 


Cuando el usuario quiera borrar un teléfono de la base de datos, hará clic en la 
opción Borrar del menú, si es que esta página no se está visualizando, introducirá 
el dato teléfono en la caja de texto y hará clic en el botón Borrar. Según esto, el 
controlador de este botón lo único que tiene que hacer es invocar al método Bo- 
rrar_telefono del servicio web pasando como argumento el teléfono: 
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protected void btBorrar_Click(object sender, EventArgs e) 
( 
// Recuperar los datos de la página web 
string teléfono = ctlelefono.Text; 
// Borrar el registro correspondiente de la base de datos 
refServiciolfnos.ServiceClient proxy = 

new refServicioTfnos.ServiceClient(); 
proxy.Borrar_telefono(teléfono); 
Response.Redirect("../Default.aspx"); 














mam) 












http://localhost/MiApTínos/Borrar/Borrar.aspx 





P ~ BÈ ||] Página borrar - Mi aplic... X | ] 





Registrarse Iniciar sesión 


Inicio Añadir Borrar Acerca de 


Página borrar teléfono. 


Use el formulario siguiente para borrar un teléfono. 





El campo teléfono es obligatorio. 











Teléfono: 











Borrar 








|© 2013 - Mi aplicación ASP.NET 

















d 


Igual que hicimos con la operación de Añadir, añada a la carpeta Borrar un 
fichero de configuración con un código análogo para que esta página solo pueda 
ser accedida por usuarios autenticados pertenecientes al grupo de “administrado- 


” 


res”, 


<system.web> 
<authorization> 
<allow roles="administradores" /> 
<deny users="*" /> 
</authorization> 
</system.web> 


CAPÍTULO 20 


O F.J.Ceballos/RA-MA 


AJAX 


AJAX, acrónimo de Asynchronous JavaScript And XML (JavaScript y XML asín- 
cronos), es una técnica de desarrollo para crear aplicaciones web interactivas. És- 
tas se ejecutan en el navegador del usuario y mantienen comunicación asíncrona 
con el servidor en segundo plano. De esta forma es posible realizar cambios sobre 
la misma página sin necesidad de recargarla. Esto significa aumentar la velocidad 
de presentación de la página favoreciendo así la interactividad con la misma. 


AJAX no constituye una tecnología en sí, sino que es un término que engloba 
a un grupo de tecnologías que trabajan conjuntamente. Estas son: 


e XML. Estándar para el intercambio de información estructurada usado común- 
mente para la transferencia de vuelta del servidor, aunque cualquier formato 
puede funcionar, incluyendo HTML preformateado, texto plano o JSON. 


e HTML, o su sucesor XHTML, y hojas de estilos en cascada (CSS). XHTML es 
la versión XML de HTML, por lo que básicamente tiene las mismas funciona- 
lidades, pero cumple las especificaciones más estrictas de XML. CSS es un 
mecanismo simple para agregar estilo (por ejemplo color, tipo de letra) a do- 
cumentos web. Con CSS se puede separar el contenido (XHTML) de la pre- 
sentación (CSS). 


e JavaScript. Es un lenguaje de script (secuencias de órdenes) interpretado. Fue 
diseñado para agregar interactividad a las páginas web y lo usual es que esté 
embebido directamente en estas. En la actualidad está soportado por casi to- 
dos los navegadores web, permite capturar eventos de la página web y tam- 
bién validar datos de la misma, así como cambiar el contenido de los 
elementos HTML de la página. Son los navegadores los que interpretan, y por 
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lo tanto ejecutan los programas escritos en JavaScript, haciendo así de las pá- 
ginas documentos dinámicos. 


e La interfaz de programación de aplicaciones DOM (Document Object Model) 
accedida con un lenguaje de secuencias de órdenes, como JavaScript, para 
mostrar e interactuar dinámicamente con la información presentada. 


e El objeto XMLHttpRequest para intercambiar datos asincrónicamente con el 
servidor web. 


Todas estas tecnologías juntas pueden lograr cosas realmente impresionantes 
como GoogleMaps, Gmail o Outlook Web Access, en el sentido de acercarnos al 
tiempo de respuesta de las aplicaciones de sobremesa. 


La interacción con una aplicación web sigue el patrón descrito por las figuras 
siguientes. Se trata de un modelo síncrono: 





navegador 
5 actividad del usuario actividad del usuario actividad del usuario 
interfaz de usuario 





solicitud HTTP 


datos HTML +CSS 


soep ap Upsiwsue 
transmidóa de datos 
soep ap UsiusueI 
transmisión de datos 





servidor web 


y A 


bases de datos, procesamiento, 
sistemas legados 


sistema procesador sistema procesador 














Mientras que el HTML Dinámico o DATML designa el conjunto de técnicas 
que permiten crear sitios web interactivos utilizando una combinación del lengua- 
je HTML, de un lenguaje interpretado en el lado del cliente, como JavaScript, el 
lenguaje de hojas de estilos en cascada (CSS) y la interfaz de programación de 
aplicaciones DOM, AJAX intenta resolver algo más. 


¿Qué intenta resolver AJAX? Permitir crear aplicaciones más ligeras y con 
mayor interactividad; esto es, que el usuario no perciba la incapacidad de no po- 
der realizar nada mientras se refresca la página en el navegador para actualizar su 
contenido. Esto es, mientras el servidor procesa una petición, además de realizar 
la persistencia de la página debido a que HTTP es un protocolo sin estado, el 
usuario espera, y esta espera puede llegar a no ser agradable. Pues bien, aquí es 
donde interviene AJAX, dándole más responsabilidad al navegador en tareas que 
antes se realizaban en el servidor, lo que redundará en menos peticiones al servi- 
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dor y menos datos enviados, o haciendo peticiones al servidor en segundo plano 
sin esperar una acción explícita del usuario, por ejemplo, porque un control nece- 
sita actualizarse. La solución pasa por un modelo asíncrono: 





navegador 


interfaz de usuario 





i actividad del usuario 





| 
llamada Javascript A 
datos ii bins +CSS 






MA 
I! 


























motor Ajax ¡ Procesamiento del cliente 
3 3 3 g 3 $ 3 $ 
3 5 2 E 2 E 2 2 
3 2 35 ME 5 3 
solicitud HTTP 3 y 3 y 3 2 T 
54 Ss $ $S $ Hp 
C E- 2 E 22 e È 
g E & 5 2 3 e $ 
datos XML $ £ E $ E $ È $ 





servidor web y/o xml procesamiento 


procesamiento 
y del servidor del servidor del servidor 


procesamiento procesamiento 


del servidor 


bases de datos, procesamiento, 
sistemas legados 


servidor 














En la figura anterior se puede observar que el navegador, en vez de cargar una 
página web completa al principio de la sesión, carga el motor AJAX que está es- 
crito en JavaScript. Este motor es el encargado de dibujar la interfaz gráfica del 
usuario y de comunicarse con el servidor de modo asíncrono utilizando el objeto 
XMLHttpRequest. De esta forma, cada acción de un usuario, que normalmente 
generaría una petición HTTP, toma la forma de una llamada al motor AJAX. Así, 
cualquier respuesta a una acción del usuario que no requiera un viaje al servidor 
(como una simple validación de datos) será producida por el motor AJAX. Si este 
motor necesita para responder algo del servidor (datos para procesar o recuperar 
nuevos datos) entonces hace la petición asincrónicamente, usando generalmente 
XML, sin frenar la interacción del usuario con la aplicación. 


FUNDAMENTOS DE AJAX 


Antes de AJAX, los avances en pos de páginas web más ricas han sido numero- 
sos. Por ejemplo, cuando apareció ASP.NET, en sus versiones 1.0 y 1.1, el trabajo 
de gestionar manualmente el estado y la persistencia de una página a través de los 
objetos Request y Response pasó a realizarse de forma automática a través del 
mecanismo ViewState, y el acceso a las propiedades de los controles de la página 
y la respuesta a sus eventos se solucionó con el sistema de postback. Recibe este 
nombre el proceso de enviar la información de un formulario web desde el nave- 
gador al servidor a través del método POST de HTTP. Esto sucede cada vez que 
un control requiere una actualización, o un método o una petición de un servicio 
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se tienen que ejecutar en el servidor. El problema de este sistema es que cada 
postback hace que se recargue la página completa, lo cual es percibido en forma 
de espera por el usuario. En un intento de mejorar estos sistemas, se publica 
ASP.NET 2.0. Con esta versión la carga que el mecanismo ViewState generaba 
en una página es reducida en un 50 % y se introducen los callbacks. Un callback 
se parece a un postback en que actualiza información en el servidor, pero no lanza 
el proceso para la totalidad de la página, sino para las partes de esta que necesiten 
actualización, dando lugar a un proceso más ligero de ejecutar. 


XMLHttpRequest 


Según expusimos en la introducción de este capítulo, una de las tecnologías que 
constituyen AJAX es la clase XMLHttpRequest, la cual está disponible en todos 
los navegadores modernos. Un objeto de esta clase permite la transferencia de da- 
tos en formato XML entre el navegador y el servidor. Esta idea fue desarrollada 
originalmente por Microsoft a través de su implementación XMLHTTP y, por 
tratarse de un objeto ActiveX (disponible desde IE 5), difiere ligeramente de la 
norma estándar publicada. Dicho objeto, en cualquiera de sus versiones, es acce- 
sible por medio de JavaScript, JScript, VBScript y otros lenguajes de secuencias 
de órdenes soportados por este navegador. 


Los métodos y las propiedades básicas de esta clase son: 


opení método, URL[, asíncronol, nombreUsuariol, clavell] ) 


Método para abrir una conexión con el servidor. El parámetro método puede 
tomar los valores “GET”, “POST” o “PUT”; URL especifica la página solicitada; 
asincrono especifica si la petición debería ser gestionada asíncronamente o no (el 
valor predeterminado es true e indica que el proceso del script continúa después 
del método send, sin esperar a la respuesta —llamada asíncrona—, y false indica 
que el script se detiene hasta que se reciba la respuesta, tras lo cual se reanuda la 
ejecución llamada sincrona—). En el caso asincrono se especificará el método que 
se ejecutará ante un cambio de estado (método callback) con el fin de tratar los re- 
sultados de la consulta una vez que se reciben, o bien de gestionar posibles errores. 


sendí contenido ) 


Método utilizado para enviar la petición. Si la petición es POST se pueden in- 
cluir los datos a enviar en contenido; en otro caso contenido valdrá null. 


abort() 


Método utilizado para cancelar la petición en curso. 
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onreadystatechange 


Propiedad que almacena el nombre del método que será invocado automáti- 
camente cuando, después de una llamada asíncrona, el proceso sobre la página so- 
licitada haya terminado satisfactoriamente o no. 


readyState 


Propiedad que almacena el estado de la petición: 0, no iniciada; 1, cargando; 
2, carga terminada pero sin procesar; 3, en curso; y 4, completada. 


status 


Propiedad que almacena el código HTTP resultado de la petición. Por ejem- 
plo: 200, operación completada con éxito; 404, recurso no encontrado, etc. 


statuslText 


Propiedad que devuelve el estado (status) como una cadena. 


responseXxML 


Propiedad que devuelve en XML el documento DOM correspondiente a la 
respuesta. 


responselext 
Propiedad que devuelve la respuesta como una cadena de texto. 


A continuación vamos a ver, con un ejemplo sencillo, cómo se utiliza la clase 
XMLHttpRequest. La aplicación consta de dos páginas: inicio.html, la que 
muestra la figura siguiente, y obtenerDatos.aspx. 


Como se puede observar en la figura siguiente, la página inicio.html presenta 
una lista con dos opciones: aptos y no aptos, y una tabla dinámica que se construi- 
rá en función de la opción elegida de la lista. La idea es centralizar la mayoría de 
las acciones en la parte del cliente. 


La página inicio.html es una página con controles HTML (básicamente un 
formulario, form, con un control select con dos opciones y un control table ini- 
cialmente con una fila para el título) y código JavaScript para resolver en el lado 
del cliente cualquier acción del usuario que no requiera un viaje al servidor: 
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ttp://localhost/AJAX1/inicio.htmi P-20 8 Página sin título | 








Hora actual: 


11:42:09 PM 


Completar una lista dinámicamente con AJAX en función de la opción elegida. 
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La página obtenerDatos.aspx incluirá la lógica de negocio en su fichero de 
código subyacente obtenerDatos.aspx.cs. Esta página, cuando sea solicitada desde 
inicio.html, devolverá un documento XML con los datos que actualizarán la tabla 
y que se encuentran en el servidor. Puede observar en el código de la aplicación 
que AutoEventWireup es true y que el fichero .aspx no contiene código HTML 
para que no sea devuelto junto con el documento XML y dé lugar en la respuesta 
a un documento XML mal formado que no se pueda recuperar. 


Según lo expuesto, de esta aplicación web nos interesa llenar dinámicamente 
la tabla mostrada. Tal funcionalidad implica una llamada del cliente (navegador 
web) al servidor, pues los datos que mostrará la tabla residen en este último. 


Existen, por lo menos, dos implementaciones posibles: 
e Una basada en el modelo clásico de aplicaciones web (sin utilizar AJAX). 
e Y otra basada en AJAX. 


En una implementación que utilice el modelo clásico de aplicaciones web: 


1. El usuario solicita el listado de alumnos aptos, o bien no aptos. Esto produce 
un evento que atiende el navegador. 


2. Como respuesta a tal evento, el navegador genera una petición HTTP que via- 
ja desde el cliente hacia el servidor. 


3. El servidor recibe la petición y ejecuta la lógica necesaria para obtener los da- 
tos de una fuente de datos. 
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4. El servidor genera la página HTML con los datos obtenidos y envía esta nue- 
va página al cliente (se envía toda la página). 


5. El cliente recibe la nueva página HTML y la muestra al usuario. 
En la implementación utilizando AJAX: 


1. El usuario solicita el listado de alumnos aptos, o bien no aptos. Esto produce 
un evento que atiende el navegador. 


2. El código JavaScript (que reside en el cliente) procesa el evento y realiza la 
llamada al servidor (petición HTTP). 


3. El servidor recibe la petición y ejecuta la lógica necesaria para obtener los da- 
tos de una fuente de datos. 


4. El servidor genera un documento XML con el resultado (los datos obtenidos) 
y lo envía al cliente. 


5. Un código JavaScript en el cliente recibe el documento XML, lo procesa y re- 
carga únicamente la sección de la página web que corresponde al listado de 
los alumnos: la tabla. 


En este ejemplo, se utiliza XML para la comunicación. Sin embargo, pueden 
emplearse otros formatos o estándares, como JSON, mucho más fácil de utilizar, 
ya que no hay que recorrer la jerarquía XML con el DOM o ir buscando nodo a 
nodo en el contenido, porque se convierte en JavaScript puro y utilizable nada 
más llegar del servidor. Tiene un par de inconvenientes: uno, que su uso con CH o 
con VB requiere un trabajo extra (para evitarlo existe la biblioteca 
http://jayrock.berlios.de que permite convertir objetos .NET a su representación 
JSON), y el otro, la seguridad, porque la utilización de la expresión eval posibilita 
la inyección de código peligroso (para evitarlo tenemos un script en 
http://www.json.org/¡son.js). 


A continuación explicaremos las partes más significativas del ejemplo. La 
aplicación completa puede obtenerla de la carpeta Cap2014JAX1 del CD. Cuando 
el usuario solicita el listado de alumnos aptos, o no aptos, se produce un evento 
onchange que atiende el navegador: 


<select name="ListaDe0pciones" id="ListaDe0pciones" size="1" 
"5 
<option value=""></option> 
<option value="APTOS">APTOS</option> 
<option value="NO APTOS">NO APTOS</option> 
</select> 
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La respuesta al evento onchange de la lista ListaDeOpciones es la ejecución 
de la función CargarElementosTabla de la página web pasando como argumento 
la opción elegida (this.value): 


function CargarElementosTabla(opcion) 
( 
ObtenerXML("obtenerDatos.aspx?opcion=" + opcion); 


} 


El código JavaScript anterior procesa el evento y construye el URL para, más 
adelante, realizar la petición HTTP al servidor. El argumento opcion valdrá AP- 
TOS o NO APTOS, valor de la opción elegida. Para realizar la petición asíncrona 
al servidor desde el código de esta página web hay que obtener una referencia al 
objeto de la clase XMLHttpRequest, aportada por el navegador, que hemos de- 
nominado PeticionHTTP. De esto se encargará el método ObtenerXML invocado 
por CargarElementosTabla: 


var PeticionHTTP; // objeto XMLHttpRequest 
var elementos; // elementos de la lista en XML 


function ObtenerXML(URL) 
( 
if C(lwindow.XMLHttpRequest) 
( 
// Nersiones de Internet Explorer inferiores a IE7 
PeticionHTTP = new ActiveX0Object("Microsoft.XMLHTTP"); 
) 
else 
( 
// Otros como IE 7, Mozilla Firefox 
PeticionHTTP = new XMLHttpRequest(); 


if (PeticionHTTP != null) 





PeticionHTTP.onreadystatechange = CargaDePaginalTerminada; 
PeticionHTTP.open("GET", URL, true) // llamada asíncrona 
PeticionHTTP.send(null); // petición HTTP GET 




















Nota: véase en el apéndice A el apartado Depurar código JavaScript. 


Una vez obtenida la referencia al objeto XMLHttpRequest utilizaremos sus 
métodos y propiedades para realizar la petición HTTP al servidor: 





PeticionHTTP.onreadystatechange = CargaDePaginalTerminada; 
PeticionHTTP.open("GET", URL, true) // llamada asíncrona 
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PeticionHTTP.sendí(null); // petición HTTP GET 


En el código anterior, la primera línea fija la función, CargaDePaginaTermi- 
nada, que se llamará automáticamente cada vez que cambie el estado de la peti- 
ción, propiedad readyState del objeto XMLHttpRequest. La segunda línea abre 
una conexión asincrona con el servidor; en este caso se usará el método GET para 
solicitar la página especificada por URL en modo asíncrono (valor true para el 
tercer parámetro). Y la tercera línea envía la petición. 


El servidor recibe la petición y ejecutará la lógica necesaria (fichero obtener- 
Datos.aspx.cs cuyo código no es relevante) para obtener los datos de una fuente 
de datos (de una base de datos, de un fichero, de una matriz en memoria, etc.). En 
el ejemplo que nos ocupa, el servidor genera un documento XML con el resultado 
de los datos obtenidos y lo envía al cliente a través del objeto Response. 


El hecho de que sea una llamada asíncrona hará que se devuelva el control 
inmediatamente a JavaScript (inicio.htm!) permitiendo al cliente seguir haciendo 
otros procesos sin que se vea interrumpida la interacción con el usuario. Obsérve- 
se que la llamada ha sido asíncrona, pero AJAX no siempre debe ser asincrono. 


Cuando el estado de la petición cambia, por ejemplo, porque el servidor la ha 
completado, el cliente, página inicio.html, recibe el documento XML y se invoca 
automáticamente a la función CargaDePaginaTerminada. Esta función verifica 
cómo ha finalizado la petición y en el caso de que el resultado haya sido satisfac- 
torio (status igual a 200) almacena la respuesta del servidor en una variable global 
de la página denominada elementos: 


function CargaDePaginalerminada() 
( 
1f (PeticionHTTP.readyState == 4) // 4: completado 
( 
if (PeticionHTTP.status == 200) // 200: OK 
{ 
// Obtener los elementos identificados por <elemento> 
elementos = 
PeticionHTTP.responseXML.getElementsByTagName("elemento"); 
CargarTabla(); 
) 
else  // Error 
( 
alert("No hay elementos para la lista de resultados: " + 
PeticionHTTP.statusText):; 
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A continuación, CargaDePaginaTerminada invoca a la función CargarTabla 


para procesar la respuesta y recargar únicamente la sección de la página web que 
corresponde al listado de los alumnos aptos o no aptos, esto es, la tabla: 


function CargarTabla() 


( 


TablaResultados = document.getElementByld("TablaDeResultados"):; 
// Fila de cabecera 

var cabecera = document.getElementByld("ListaDe0pciones").value + 
" EN LAS PRÁCTICAS DE PROGRAMACIÓN VISUAL"; 
TablaResultados.rows[0].cel1s[0].innerHTML = cabecera; 

// Resto de filas 

if (TablaResultados != null) 

( 





if (TablaResultados.rows.length > 1) 
BorrarFilas(TablaResultados); // vaciar la tabla de resultados 
// Añadir los elementos obtenidos a la tabla de resultados 
forívar e = 0; e < elementos.length; e++) 
( 
AnyadirFila(TablaResultados):; 
TablaResultados.rows[e+1].cel1s[1].innerHTML = 
elementos[e].childNodes[0].nodeValue; 


Nótese que no se ha recargado la página totalmente, solamente se ha recarga- 


do una parte, la que ha variado. 


Ahora que ya conocemos la base de AJAX, comentemos algunas considera- 


ciones a tener en cuenta: 


Llamadas fuera de dominio. Dado que los servicios web devuelven XML, se- 
gún lo descrito, podríamos pensar en realizar búsquedas en otros dominios, 
por ejemplo en Amazon, utilizando su API. Evidentemente, por razones de 
seguridad, los navegadores bloquean todas las peticiones realizadas a través 
de XMLHttpRequest a dominios diferentes al que aloja la página desde la 
que se hace la llamada. Está claro que esto supone una limitación importante. 
La pregunta es: ¿cómo salvamos este problema? La solución pasa por llevarse 
el problema al servidor para no depender del navegador. Para ello lo que po- 
demos hacer es construir un proxy, al que sí podremos acceder con AJAX, y 
que sea este el que se encargue de realizar las llamadas a otros dominios. 
ASP.NET AJAX ofrece esta posibilidad. 


Llamadas que producen errores o que no retornan. Los errores habrá que 
controlarlos a través del código de estado que devuelva el servidor. Ahora, 
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cuando se trate de una llamada asíncrona hecha al servidor que no retorna, o 
no lo hace en un tiempo razonable, no nos sirve el código 2, lo que tendremos 
que hacer es utilizar un temporizador para esperar un tiempo máximo, trans- 
currido el cual, anulamos la petición: 


// Temporizador de 15 segundos 
var temporizadorl15 = setTimeout("AnularPeticion()", 15000); 


function AnularPeticion() 
( 

PeticionHTTP.abort():; 
) 


11 


function CargaDePaginalerminada() 
( 
if (PeticionHTTP.readyState == 4) // 4: completado 
( 
clearTimeout(temporizador15); 


1! 


Un temporizador se crea invocando a la función setTimeout y se destruye in- 
vocando a la función clearTimeout. Supongamos que modificamos la página 
inicio.html según muestra el código anterior. Cuando se cargue esta página se 
creará un temporizador de 15 segundos y se realizará la petición de cargar la 
página obtenerDatos.aspx. Si los datos esperados del proceso de esta página 
no llegan pasados 15 segundos, se ejecutará la función AnularPeticion dando 
por finalizada la misma; en otro caso, se ejecutará CargaDePaginaTerminada 
y se destruirá el temporizador. 


Envío de datos utilizando el método POST. Para enviar datos al servidor utili- 
zando POST en vez de GET, modifique: 


function ObtenerXML(URL, opcion) 
( 
if (Iwindow.XMLHttpRequest) 
( 
// Versiones de Internet Explorer inferiores a IE7 
PeticionHTTP = new ActiveXObject("Microsoft.XMLHTTP"); 
) 


else 
( 
// Otros como IE 7, Mozilla Firefox 


1032 ENCICLOPEDIA DE MICROSOFT VISUAL C# 


PeticionHTTP = new XMLHttpRequest(); 
) 


if (PeticionHTTP != null) 
( 
PeticionHTTP.onreadystatechange = CargaDePaginaTerminada; 
PeticionHTTP.open("POST", URL, true); 
PeticionHTTP.setReguestHeader("Content-Type", 
"application/x-www-form-urlencoded”); 
PeticionHTTP.send("opeion="+opcion); // petición HTTP POST 





Obsérvese que ahora en el método open el primer parámetro es POST. Tam- 
bién hay que invocar a la función setRequestHeader para especificar el atri- 
buto Content-Type en la cabecera de la petición HTTP. Es importante tener 
en cuenta que para invocar a setRequestHeader el valor de readyState tiene 
que ser 1, por eso hemos hecho la llamada después de open. Finalmente, el 
argumento de send tiene que ser de la forma: 


paraml=valor] & param2=valor2... 


La recuperación de los valores en la página solicitada no cambia: 


string op = Request.Params["opcion"]; 


AJAX con ASP.NET 


ASP.NET 2.0 introduce una nueva técnica para implementar páginas AJAX de- 
nominada script callbacks. El objetivo de script callbacks es poder generar peti- 
ciones asincrónicas desde el lado del cliente (navegador) al servidor cuando sea 
necesario refrescar parcialmente una página evitando así tener que cargar y gene- 
rar toda la página. Según esto, la técnica de script callbacks persigue los mismos 
objetivos que AJAX, pero hay una diferencia fundamental entre esta técnica y lo 
que hemos expuesto en el apartado anterior y es que script callbacks nos permite 
abstraernos del manejo de la clase XMLHttpRequest, incluyendo el tratamiento 
de los errores, resultando un proceso más simplificado, ya que .NET se encarga 
prácticamente de todo de una manera transparente. Resumiendo, se trata de una 
técnica para realizar postbacks en segundo plano, utilizando el modelo de eventos 
de servidor .NET, para recargar la parte de la página que nos interese sin que el 
usuario aprecie las idas y venidas hacia y desde el servidor. 


En la implementación de nuestro ejemplo (véase la carpeta Cap20/AJAX2) 
utilizando script callbacks: 
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El usuario solicita el listado de alumnos aptos, o bien no aptos, interactuando 
con la página Default.aspx. Para ello, la página tiene que tener un elemento 
que genere un evento que esté vinculado con la llamada callback. Es esencial 
que el elemento no sea un botón de tipo “submit” (botón de envío de formula- 
rio). Por esta razón, no se puede utilizar un botón de la clase <asp:button> 
(pero sí se puede utilizar un botón HTML que se ejecute en el servidor), por- 
que aunque el código del cliente se ejecuta correctamente, después la página 
vuelve y cancela todos los cambios dinámicos realizados. 


El código JavaScript (que reside en el cliente) procesa el evento y realiza la 
llamada al servidor (petición HTTP) mediante la función JavaScript 
WebForm_DoCallback aportada por ASP.NET. 


El servidor recibe la petición y ejecuta la lógica necesaria para obtener los da- 
tos de una fuente de datos mediante la función RaiseCallbackEvent aportada 
por la interfaz ICallbackEventHandler de ASP.NET. 


El servidor genera el resultado (los datos obtenidos) y lo envía al cliente por 
medio de la función GetCallbackResult aportada por la interfaz ICallback- 
EventHandler de ASP.NET. 


Una función JavaScript en el cliente (clienteCallback: CargarTabla en nues- 
tro caso) recibe el resultado, lo procesa y recarga únicamente la sección de la 


página web que corresponde al listado de los alumnos: la tabla. 


La figura siguiente resume el mecanismo callback: 


r (IE, Firefox, etc.) 
| elemento de inicio | 
1 


ASP.NET 
Response Request 
string GetCallbackResult() {...} 





—O 
void RaiseCallbackEvent(string s) (...) ICallbackEventHandler 


1034 ENCICLOPEDIA DE MICROSOFT VISUAL C# 


Básicamente, considere la técnica de los script callbacks proporcionada por 
ASP.NET 2.0 como la versión simplificada de lo que hemos utilizado en el marco 
de AJAX, ya que con esta técnica se utiliza en el lado del cliente un controlador 
especial que se denomina WebResource.axd proporcionado por ASP.NET que en- 
capsula la lógica de las llamadas en segundo plano, mientras que AJAX utiliza un 
objeto XMLHttpRequest. 


No ahondamos más en esta técnica porque ha sido ampliamente superada por 
ASP.NET AJAX que exponemos a continuación. 


GENERACIÓN DE CÓDIGO JAVASCRIPT 


De lo expuesto hasta ahora en este capítulo deducimos que derivar la ejecución de 
ciertas tareas al navegador es primordial si se quiere conseguir una aplicación 
equilibrada, en lo que a consumo de recursos se refiere, y ágil, en cuanto a su eje- 
cución. Esta forma de proceder descarga al servidor de muchas tareas que de otro 
modo tendría que soportar. 


¿Qué mecanismos tiene ASP.NET para generar código JavaScript que se eje- 
cute en el navegador? Tiene varios, algunos de ellos, como colocar scripts delimi- 
tados por las etiquetas <script></script>, ya han sido utilizados y otros los 
explicaremos a continuación. Como ejemplo, eche una ojeada a la página De- 
fault.aspx de la aplicación anterior: 


<html xmlns="http://www.w3.org/1999/xhtml"> 
<head runat="server"> 
<title>Página sin título</title> 


<script language="javascript" type="text/javascript"> 
al 


Código JavaScript 


IN E 
</seript> 


</head> 

<body> 
<img sre="ceballos.png" width="120" /> 
<p»<seript>hora[)</script>»</p> 


<form id="forml" runat="server"> 
<div> 
</div> 

</form> 
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</body> 
</html> 


En el código anterior observamos dos scripts: uno entre las etiquetas 
<head></head> y otro entre las etiquetas <body></body>. Este es el estilo más 
antiguo que conocemos de colocar código JavaScript en una página. 


Fichero JavaScript 


Observando nuestra aplicación vemos que tenemos varias funciones JavaScript. 
Podemos agregar a nuestra aplicación un fichero .js y guardar en él todas esas 
funciones o las que creamos conveniente. Esto nos permitiría utilizar estas fun- 
ciones no solo en la página donde ahora las estamos utilizando, sino en cualquier 
otra página. Para ello, bastaría con incluir una referencia a ese fichero en las pági- 
nas que vayan a utilizar alguna de las funciones que aporta, según muestra el si- 
guiente código (ejemplo 4J4X2): 


<html xmlns="http://www.w3.org/1999/xhtml"> 
<head runat="server"> 
<title>Página sin título</title> 


<seript language="javascript" sre="funciones.js"></script> 
</head> 
<body> 


Vincular un evento con una función JavaScript 


Un control que se ejecute en el lado del servidor muestra todos sus atributos como 
propiedades, lo cual favorece el desarrollo en este lado. Por ejemplo, en ocasio- 
nes, como ocurre en nuestra aplicación, tendremos que vincular un evento de un 
control de la página con una función JavaScript; en nuestra aplicación hemos ne- 
cesitado que cuando se produzca el evento onchange de la lista desplegable se 
ejecute la función JavaScript WebForm_DoCallback. Para realizar esta asocia- 
ción, lo más habitual es almacenar el script en un string, en nuestro caso identifi- 
cado por callback; precisamente esto es lo que hace la siguiente función en el lado 
del servidor, función que será invocada en el instante en el que se carga la página: 


private string JavaScriptCallback() 
( 
// Obtener el Id de la lista 
string IdLista = this.ListaDe0pciones.ClientID; 
// Construir la sentencia javascript para obtener el elemento 
// seleccionado en la lista 
string opcionlLista = string.Format( 
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"document.getElementByld(”(0)”).value", IdLista); 
// Construir la llamada en segundo plano hacia el servidor 
string callback = Page.ClientScript.GetCallbackEventReference(l 
this, opcionLista, "Cargarlabla", 


"null", "Error", true); 
// Construir la llamada en segundo plano en javascript 
return string.Format("javascript:1f0)", callback); 


Una vez generado el script, asignaremos a la colección de atributos de la lista 
referenciada por su propiedad Attributes, el par de valores: onchange—Java- 
ScriptCallback() especificando así que cuando se produzca el evento onchange en 
la lista, la respuesta será la ejecución de la función JavaScriptCallback. 


protected void Page_load(object sender, EventArgs e) 
( 
if (lIsCallback) 
( 
// Asignar la llamada en segundo plano al evento onchange de la lista 
this.ListaDeO0pciones.Attributes["onchange"] = JavaScriptCallback(); 
) 


El método anterior se ejecutará cada vez que se cargue la página que lo defi- 
ne; en nuestro caso Default.aspx. La propiedad IsCallback de Page valdrá true si 
la solicitud de la página es el resultado de una devolución de llamada; de lo con- 
trario, valdrá false. Según esto, cuando la página es actualizada parcialmente no 
es necesario volver a realizar la vinculación del evento con la función JavaScript 
especificada; sí será necesario cuando la página se actualice en su totalidad. En es- 
te caso, el código señalado a continuación, producido en el lado del servidor, será 
añadido a la página HTML: 


<select name="ListaDe0pciones" id="ListaDe0pciones" 





<option value=""></option> 
<option value="APTOS">APTOS</option> 
<option value="NO APTOS">NO APTOS</option> 
</select> 


Ahora, cada vez que se ejecute la página y se seleccione una opción de la lista 
se invocará a la función JavaScript especificada. 
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Inyectar código JavaScript desde el lado del servidor 


Además de los mecanismos descritos para añadir código JavaScript a una aplica- 
ción, ASP.NET aporta otros que permiten añadir dicho código desde el lado del 
servidor, útiles en situaciones en las que se necesita agregar dinámicamente la se- 
cuencia de órdenes al navegador. 


Estos nuevos mecanismos son aportados por los métodos del objeto Client- 
SeriptManager referenciado por la propiedad ClientScript de Page, de los cua- 
les, en función del objetivo perseguido, vamos a comentar dos: Register- 
StartupScript y RegisterClientScriptBlock. El primero permite inyectar código 
antes de la etiqueta de cierre del formulario, etiqueta </form>, y el segundo des- 
pués de la etiqueta de apertura, <form>. Utilizaremos uno u otro en función de 
que el código JavaScript inyectado necesite que los controles del formulario ten- 
gan o no que estar definidos cuando se ejecute dicho código porque haga referen- 
cia a los mismos. Ambos métodos tienen varias sobrecargas, y todas ellas tienen, 
al menos, tres argumentos: el tipo y la clave, para identificar de forma única la se- 
cuencia de órdenes de inicio que se va a registrar, y la cadena que almacena dicha 
secuencia. 


protected void Page_load(object sender, EventArgs e) 
( 
if (lIsCallback) 
( 
1/ 
// Desplegar una ventana popup 
string NL = System.Environment.NewLine; 
string popupScript = 
"<script language=*JavaScript'>" + NL + 
"window.open(*Saludo.html*, ”CustomPopUp”, 
"*width=200, height=150*)" + NL + 
"</script>"; 
Page.ClientScript.RegisterStartupScript(typeof(_Default), 
"PopupScript", popupSecript); // antes de </form> 


"4 








El primer parámetro podría haberse especificado también así: this. GetType(), 
pero esto puede dar lugar a que se registre el mismo script dos veces cuando es- 
temos trabajando con clases derivadas (un objeto se deriva de otro), por eso se re- 
comienda utilizar tipos específicos (_Default, en nuestra aplicación AJAX3, es la 
clase de la página). 


Para verificar si un determinado script ya ha sido registrado en el formulario 
web, el objeto ClientScriptManager proporciona los métodos IsClientScript- 
BlockRegistered e IsStartupScriptRegistered. Por ejemplo: 
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if (lPage.ClientSeript.IsStartupScriptRegistered("PopupSeript")) 
Page.ClientSeript.RegisterStartupSeript(typeof(_Default), 
"PopupSeript”, popupScript); // antes de </form> 


ASP.NET AJAX 


Según lo expuesto hasta ahora, el desarrollo de aplicaciones con AJAX requiere 
programación en el lado del cliente, y esto a su vez requiere del conocimiento de 
diversas tecnologías: XHTML, DOM, JavaScript, etc. Para salvar el tener que 
dominar tantas tecnologías, Microsoft desarrolló unas extensiones de ASP.NET (a 
partir de su versión 2.0) que, finalmente, denominó ASP.NET AJAX. 


ASP.NET AJAX es un entorno de desarrollo de libre distribución para crear 
aplicaciones basadas en AJAX que puedan ejecutarse desde todos los navegadores 
más populares. Este entorno ha sido creado para facilitar el uso de AJAX y exten- 
der los beneficios del mismo sobre la plataforma ASP.NET. Esta facilidad llega 
hasta tal punto que puede eximir al programador de escribir el código JavaScript 
en el lado del cliente necesario para incorporar AJAX en una aplicación web, se- 
gún estudiamos en los apartados anteriores. 


ASP.NET AJAX incluye una biblioteca de scripts para programar en el lado 
del cliente y las extensiones del servidor: 


Â Cliente P Servidor 


Microsoft AJAX Library Características AJAX 
= para ASP.NET 
Componentes > a 
Controles, Comportamientos, Compatibilidad para scripts 
Componentes no visuales ) Modo de Lanzamiento/Depuración, 


; Registro, Localización 
(Compatibilidad del explorador) ` J 




















Compatibilidad con Servicios web 
Microsoft Internet Explorer, Generación de proxy, 
Mozilla Firefox, Apple Safari Métodos de página, 

J Serialización XML y JSON 
( Redes > $ 
Solicitudes asincrónicas, Servicios de aplicación 
Serialización XML y JSON, Autenticación, 


Servicios de aplicación y web ) Perfil, Funciones 




















r N 
Core Services | í Controles de servidor 
paa polo ve rct ScriptManager, UpdatePanel, 
' , UpdateProgress, Timer 
Depuración, Control de L di podi J 
errores, Globalización 
< J 





La biblioteca Microsoft AJAX Library es la base de código JavaScript 
(proporciona una funcionalidad similar a .NET Framework) y la abstracción del 
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objeto XMLHttpRequest para desarrollar en el lado del cliente. Incluye software 
para la creación de componentes, la capa de compatibilidad de exploradores, la 
capa de conexión de red y servicios básicos. 


Las partes del servidor que admiten la programación en AJAX están com- 
puestas por controles de servidor web de ASP.NET y componentes que adminis- 
tran la interfaz de usuario y el flujo de una aplicación. Las partes del servidor 
también administran la seriación, validación, extensibilidad de los controles, etc. 
Existen también servicios web ASP.NET que habilitan el acceso a servicios de 
aplicación ASP.NET para la autenticación de formularios, funciones y perfiles de 
usuario. 


Resumiendo, ASP.NET AJAX permite implementar AJAX en sitios 
ASP.NET mediante el uso de controles de servidor. Esto es, siguiendo con la for- 
ma de trabajo de ASP.NET, los desarrolladores programan sus aplicaciones de la 
manera convencional y cuando desean usar AJAX solo tienen que agregar algunos 
de los controles que las extensiones ASP.NET AJAX proveen, y el entorno de 
desarrollo, a partir de esta biblioteca, se encargará de realizar la generación del 
código JavaScript correspondiente para realizar los procesos en segundo plano. 


Según lo expuesto, lo primero que hay que hacer para utilizar AJAX es asegu- 
rarnos de que ASP.NET incluye esa biblioteca. Pensando en Windows, tenga pre- 
sente que ASP.NET AJAX forma parte de ASP.NET a partir de la versión 3.5, por 
lo que no se requiere ninguna descarga adicional ni plantilla adicional, y también 
está disponible como un paquete separado para ASP.NET 2.0; en este último caso, 
tendrá que descargar de http://www. asp.net/ajax/ el paquete ASP.NET 2.0 Exten- 
siones AJAX 1.0 (ASPAJAXExtSetup.msi) e instalarlo. 


Según lo expuesto, para crear una aplicación web con AJAX, arranque Visual 
Studio o Visual Studio Express para Web, cree un nuevo sitio web y utilice los 
controles de servidor para AJAX como explicaremos a continuación. 


Crear un sitio web ASP.NET AJAX 


Partiendo de que estamos utilizando Visual Studio 2008 o superior (por ejemplo 
Visual Studio 2012), crear un sitio web habilitado para AJAX no difiere de lo que 
ya hemos estudiado. Abra Visual Studio o Visual Studio Express para Web y se- 
leccione Archivo > Nuevo > Sitio web. Se visualizará la ventana siguiente: 
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Nuevo sitio web Lo mesas) 
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Visual Basic el Sitio de ASP.NET Web Forms Visual C# 
Visual CF cs 
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y! 


Seleccione la plantilla Sitio web vacío de ASP.NET, la ubicación HTTP, es- 
criba el nombre de la carpeta donde se guardará el sitio web, por ejemplo Si- 
tioWebAJAX, seleccione el lenguaje y haga clic en el botón Aceptar. Visual 
Studio crea el sitio web vacío. 


Una vez construido el esqueleto de la aplicación puede observar que el cuadro 
de herramientas del entorno de desarrollo incluye una ficha Extensiones AJAX, 
con los controles de las clases siguientes: ScriptManager, UpdatePanel, Upda- 
teProgress, Timer y ScriptManagerProxy. 


Clase ScriptManager 


Por lo estudiado hasta ahora, sabemos que las aplicaciones basadas en AJAX uti- 
lizan bastante código JavaScript en el lado del cliente; por lo tanto, se ha de dis- 
poner de un gestor que administre las peticiones realizadas desde estos scripts al 
servidor y las respuestas de este, además de incluir los scripts de Microsoft AJAX 
Library. Este gestor es el control ScriptManager. Toda página en la que desee- 
mos incluir Extensiones AJAX tiene que incorporar este control. 


<body> 
<form id="forml" runat="server"> 
<asp:ScriptManager ID="ScriptManagerl" runat="server"> 
</asp:ScriptManager> 
<div> 
</div> 
</form> 
</body> 
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El control ScriptManager tiene varias propiedades de interés entre las cuales 
destacamos las siguientes: 


e  ScriptPath. Permite especificar la ruta desde donde deberían ser cargados los 
scripts en caso de querer utilizar una versión diferente a la ofrecida por Mi- 
crosoft AJAX Library. 


e AsyncPostBackErrorMessage. Almacena el mensaje que será enviado al 
cliente cuando en el servidor se produce una excepción y no se atrapa. Cuan- 
do ocurre un error durante una llamada asíncrona se produce el evento 
AsyncPostBackError, por lo tanto esta propiedad puede ser accedida desde 
el marco de la página o desde el manejador de este evento. 


e AsyncPostBackTimeout. Almacena el tiempo máximo que habrá que esperar 
por una llamada asíncrona. Si no hay una respuesta en este tiempo la llamada 
se da por finalizada. 


e  IsInAsyncPostBack. Se utiliza en combinación con la propiedad IsPostBack 
de la página para distinguir entre la carga inicial de la página, una actualiza- 
ción parcial y una actualización total de la página en los eventos Load, Init- 
Complete y PreRender. Vale true cuando la llamada en segundo plano se 
está ejecutando; en otro caso vale false. 


e  EnablePartialRendering. Su valor por omisión es true, lo cual significa que 
está habilitada la actualización parcial de la página y la actualización total su- 
primida; de otra forma, el valor sería false. 


e Scripts. Colección de scripts que el control SeriptManager debe incluir en la 
página. Estos serán fusionados con los scripts de ScriptManagerProxy du- 
rante la ejecución. 


e Services. Colección de referencias a servicios web que el control ScriptMa- 
nager debe incluir en la página. Estos serán fusionados con las referencias a 
servicios web de ScriptManagerProxy durante la ejecución. 


e Expressions. Permite especificar dónde se cargará el valor asignado a cada 
propiedad del control (una base de datos, ficheros, etc.). 


Este control es necesario en cada página que vaya a utilizar las extensiones de 
AJAX. Una vez una página expone un control SeriptManager, el resto de los 
controles pueden registrar sus scripts y hacer uso de las llamadas asíncronas en 
segundo plano (postbacks asíncronos). 
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Sólo puede haber un control ScriptManager por página. Por lo tanto, en caso 
de utilizar páginas maestras (MasterPage) o controles de usuario (UserControls) 
la práctica habitual es incluirlo en la página maestra y en el resto de páginas utili- 
zar el control SeriptManagerProxy. Este control proporciona la misma funciona- 
lidad que ScriptManager, con la diferencia de que no registra todos los scripts y 
servicios, sino solo aquellos que hayamos especificado en el mismo. Durante la 
ejecución se mezclará la información proporcionada por el control principal y por 
todos los proxies para ser enviada al cliente. 


Continuando con la aplicación, vamos a implementar una página, como la de 
la figura siguiente, para mostrar en una rejilla los alumnos aptos o no aptos matri- 
culados en una determinada asignatura. Esta página permitirá también realizar 
modificaciones sobre los registros mostrados. La página se derivará de una página 
maestra y los datos se obtendrán de una base de datos. 
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Empecemos entonces por crear una base de datos que, en nuestro caso, vamos 
a llamar bd_ alumnos y que va a tener una tabla denominada alumnos: 


CREATE DATABASE bd_alumnos 
USE bd_alumnos 
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CREATE TABLE alumnos 
( 


id_alumno INT PRIMARY KEY, 
nombre VARCHAR(50) NOT NULL, 
apto BIT NOT NULL 





) 


No olvide dar permisos al usuario NT AUTHORITY Servicio de Red para que 
pueda acceder a esta base de datos. 


Una vez creada la base de datos puede añadir datos a la tabla. El siguiente pa- 
so es diseñar la interfaz gráfica. 


Agregamos al proyecto un nuevo elemento de tipo página maestra (Master- 
Page) con un fichero de código subyacente: MasterPage.master y MasterPa- 
ge.master.cs. Añadimos al formulario el objeto ScriptManager, un encabezado 
“Listado de alumnos aptos/no aptos” y, opcionalmente, podemos añadir algunas 
imágenes, una hoja de estilo que facilite el diseño y cualquier script que pueda ser 
necesario en el lado del cliente. En nuestro caso hemos añadido la hoja de estilos 
HojaDetEstilos.css, el fichero funciones.js que contiene la función JavaScript hora 
y el logo imagenes/ceballos.png: 


<head runat="server"> 
<title>ASP.NET AJAX</title> 
<link href="HojaDeEstilos.css" rel="stylesheet" type="text/css" /> 
<script type="text/javascript" language="javascript" 
sre="funciones.js"> 
</script> 
</head> 
<body> 
<form id="form1" runat="server"> 
<asp:ScriptManager ID="ScriptManagerl" runat="server" /> 
<div> 
<img src="imagenes/ceballos.png" width="120" alt="logo ceballos" /> 
<p><script type="text/javascript">hora()</script></p> 
</div> 
<div class="cabecera"> 
<h1>Listado de alumnos aptos/no aptos</h1> 
</div> 
<div> 
<asp:ContentPlaceHolder id="ContentPlaceHolder1" runat="server"> 


</asp:ContentPlaceHolder> 
</div> 
</form> 
</body> 
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Un control ContentPlaceHolder define en la página maestra/principal una 
región relativa para contenido y representa el texto, el marcado y los controles de 
servidor de un control Content relacionado situado en una página de contenido: 
página derivada de la página maestra. 


La aplicación completa puede obtenerla de la carpeta Cap20SitiowebAJAX 
del CD. 


Una vez diseñada la página principal, vamos a añadir al proyecto un nuevo 
formulario web (una página de contenido). Este formulario, Default.aspx, se deri- 
vará de la página maestra: 


<%@ Page Title="" Language="Cjf" 
MasterPageFile="-=/MasterPage.master" AutoEventWireup="true" 
CodeFile="Default.aspx.cs” Inherits="_Default" %> 


<asp:Content ID="Content1" 
ContentPlaceHolderlD="ContentPlaceHolderl1" Runat="Server"> 
<asp:ScriptManagerProxy ID="ScriptManagerProxy1" runat="server" /> 


</asp:Content> 


Observe el control Content relacionado con el control ContentPlaceHolder 
de la página maestra destinado para el contenido de esta página. Añada sobre este 
control un control ScriptManagerProxy cuya función, como ya dijimos, será ges- 
tionar las peticiones y respuestas AJAX. 


A continuación, añada a la página Default. aspx un texto “Opción:” y una lista 
desplegable: control DropDownList. Después, configure la lista desplegable para 
que muestre dos elementos: APTOS (registros de la tabla que tienen el campo ap- 
to igual a true) y NO APTOS (registros de la tabla que tienen el campo apto igual 
a false) y asigne a su propiedad AutoPostBack el valor true: 


<asp:Content ID="Content1" 
ContentPlaceHolderlD="ContentPlaceHolder1" Runat="Server"> 
<asp:ScriptManagerProxy ID="ScriptManagerProxy1" runat="server"/> 
Opción: 
<asp:DropDownList ID="DropDownListl" runat="server" 
AutoPostBack="True"> 
<asp:ListItem Selected="True" Value="true">APTOS</asp:Listltem> 
<asp:ListItem Value="false">NO APTOS</asp:ListItem> 
</asp:DropDownList> 
</asp:Content> 











Para acceder a la base de datos vamos a añadir al formulario un objeto SqlDa- 
taSource. Después lo configuramos para que actúe como un DataSet (valor por 
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omisión de la propiedad DataSourceMode) y para que permita recuperar de la 
tabla alumnos de la base de datos bd_ alumnos los registros correspondientes a los 
alumnos aptos o no aptos, opción que elegiremos desde una lista desplegable. 
También, permitirá las operaciones de insertar, borrar y actualizar registros en la 
base de datos, lo que implica asignar las sentencias SQL correspondientes a las 
propiedades que este control presenta para tal fin. El código siguiente muestra esta 
configuración: 


<asp:SqlDataSource ID="SqlDataSourcel” runat="server" 
ConnectionString= 
"<%$ ConnectionStrings:bd_alumnosConnectionString %>" 






































SelectCommand="SELECT 1d_alumno, nombre, apto FROM alumnos 
WHERE (apto = Qapto)" 
DeleteCommand="DELETE FROM alumnos WHERE id_alumno = @id_alumno" 
UpdateCommand="UPDATE alumnos SET nombre = Gnombre, apto = GQapto 
WHERE (id_alumno = (Cid_alumno)" 
InsertCommand="INSERT INTO alumnos (1d_alumno, nombre, apto) 
VALUES (Cid_alumno, Cnombre, @apto)"> 
<SelectParameters> 
<asp:ControlParameter ControlID="DropDownList1" Name="apto" 
PropertyName="SelectedValue" /> 


</SelectParameters> 












































<DeleteParameters> 

<asp:Parameter Name="id_alumno" /> 
</DeleteParameters> 
<UpdateParameters> 

<asp:Parameter Name="nombre" /> 

<asp:Parameter Name="apto" /> 

<asp:Parameter Name="id_alumno" /> 
</UpdateParameters» 
<InsertParameters> 

<asp:Parameter Name="id_alumno" /> 

<asp:Parameter Name="nombre" /> 

<asp:Parameter Name="apto" /> 
</InsertParameters> 

</asp:SqlDataSource> 


Para mostrar la lista de aptos o no aptos vamos a utilizar una tabla (una reji- 
lla). Por lo tanto, añada un control GridView a la página Default.aspx. El paso si- 
guiente es vincular esta rejilla con la tabla alumnos del conjunto de datos y 
configurarla para que permita la paginación de la rejilla y la ordenación de los 
elementos de las columnas, así como la edición y eliminación de filas. Así mismo, 
para que funcionen las características de actualización y eliminación automática 
del control GridView, debe establecer la propiedad DataKeyNames con el valor 
de la clave id_alumno para que pueda compararlo con el de la fila que se va a ac- 
tualizar o eliminar. La columna que corresponde al campo especificado en la pro- 
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piedad DataKeyNames es de solo lectura. Según lo expuesto, la configuración 
para nuestra rejilla sería así: 


<asp:GridView ID="GridViewl" runat="server" 
DataSourcelD="SqlDataSourcel" 
DataKeyNames="id_alumno" 
AllowPaging="True" 
AllowSorting="True" 
AutoGenerateColumns="False" > 
<Columns> 
<asp:CommandField ShowEditButton="True" ShowDeleteButton="True" /> 
<asp:BoundField DataField="1d_alumno" HeaderText="ID alumno” 
SortExpression="1d_alumno" /> 
<asp:BoundField DataField="nombre" HeaderText="Nombre" 
SortExpression="nombre" /> 
<asp:CheckBoxField DataField="apto" HeaderText="Apto" 
SortExpression="apto" /> 








</Columns> 
</asp:GridView> 


Si está utilizando una hoja de estilos puede asignar, a través de la ventana de 
propiedades de la rejilla, un valor a su propiedad CssClass, así como aplicar o no 
estilo alternativo a sus filas (propiedad AlternatingRowStyle) y especificar si se 
mostrarán líneas entre sus celdas (propiedad GridLines). 


En combinación con un control GridView, podemos utilizar para los escena- 
rios maestro-detalle un control DetailsView. Este control permite mostrar, editar, 
eliminar e insertar registros de un origen de datos. Entonces, lo siguiente que va- 
mos a hacer es añadir este control al formulario. Después, configúrelo para que 
utilice como origen de datos Sqg/DataSourcel, permita la inserción de registros 
nuevos (propiedad DefaulMode igual a insert) y asigne también la clave primaria 
a su propiedad DataKeyNames. 


<asp:DetailsView ID="DetailsViewl1" runat="server" 
DataSourcelD="SqlDataSourcel" DataKeyNames="1d_alumno” 
DefaultMode="Insert" AutoGenerateRows="false" GridLines="None"> 
<Fields> 
<asp:BoundField DataField="1id_alumno" HeaderText="ID alumno" /> 
<asp:BoundField DataField="nombre" HeaderText="Nombre" /> 
<asp:CheckBoxField DataField="apto" HeaderText="Apto" /> 
<asp:CommandField ShowlInsertButton="True" /> 
</Fields> 
</asp:DetailsView> 


Fields representa una colección de los campos de una fila declarados explici- 
tamente en un control DetailsView. 
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Así mismo, si está utilizando una hoja de estilos puede asignar, a través de la 
ventana de propiedades del control, un valor a su propiedad CssClass, así como 
especificar si se mostrarán líneas entre sus celdas (propiedad GridLines). 


Puede también añadir el método Page_Error a la página Default. aspx con el 
fin de atrapar los posibles errores que se puedan producir, por ejemplo introducir 
una clave duplicada. Este método mostrará en una página HTML el mensaje co- 
rrespondiente al error producido y permitirá al usuario volver a la página De- 
fault.aspx. 


Ahora podemos ejecutar la aplicación y comprobar su funcionamiento. Para 
observar de una forma clara que en cada interacción del usuario con la página (in- 
sertar un nuevo registro, modificar un registro, etc.) se hace una llamada al servi- 
dor produciendo la recarga total de la página, recuerde que introdujimos en la 
página maestra una función JavaScript hora para mostrar la hora actual (en el ins- 
tante en el que se carga toda la página). 


El objetivo en el diseño de esta aplicación, y en general de cualquier aplica- 
ción web, es proporcionar al usuario una interfaz más dinámica donde no se pro- 
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duzcan recargas de toda la página por cada acción que ejerza sobre la interfaz grá- 
fica. Precisamente esto es lo que proporciona AJAX: realizar peticiones asíncro- 
nas al servidor sin que el usuario perciba dichas peticiones. Por tanto, pensando 
en AJAX, habrá que determinar la zona o zonas de la página que sufrirán actuali- 
zaciones asíncronas. En nuestro ejemplo estas zonas son los controles GridView 
y DetailsView. 


Clases ScriptManager y ScriptManagerProxy 


Según expusimos anteriormente, cada página que vaya a utilizar las extensiones 
de AJAX necesita incluir un control SeriptManager. Una vez una página expone 
un control ScriptManager, el resto de los controles pueden registrar sus scripts y 
hacer uso de las llamadas asíncronas en segundo plano. 


También dijimos que solo puede haber un control ScriptManager por página. 
Por lo tanto, en caso de utilizar una página maestra (MasterPage) lo habitual es 
incluirlo en esa página y en el resto de páginas que se deriven de esta utilizar el 
control ScriptManagerProxy. Este control proporciona la misma funcionalidad 
que SeriptManager, con la diferencia de que no registra todos los scripts y servi- 
cios, sino solo aquellos que hayamos especificado en el mismo. Durante la ejecu- 
ción se mezclará la información proporcionada por el control principal y por todos 
los proxies para ser enviada al cliente. 


Por lo tanto, como siguiente paso, asegúrese de que en la página MasterPa- 
ge.master hay un control ScriptManager y en la página Default.aspx hay un con- 
trol ScriptManagerProxy: 


<!l=Página maestra --> 
<body> 
<form id="forml" runat="server"> 
<asp:SecriptManager ID="SecriptManagerl" runat="server" /> 


<!—Página de contenido --> 
<asp:Content ContentPlaceHolderID="ContentPlaceHolderl" 
ID="Content1" runat="server"> 
<asp:ScriptManagerProxy ID="ScriptManagerProxy1" runat="server" /> 


Clase UpdatePanel 


Una vez determinadas las zonas actualizables en la página, necesitamos un conte- 
nedor que permita su actualización asíncrona. En Extensiones AJAX este contene- 
dor es UpdatePanel y, al igual que PlaceHolder o Panel, almacena controles 
ASP.NET o HTML; en este caso, todos aquellos que definen las zonas actualiza- 
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bles de la página. Además, estos controles tienen que ser incluidos dentro de las 
etiquetas <ContentTemplate> de un control UpdatePanel: 


<asp:UpdatePanel ID="UpdatePanell" runat="server"> 
<ContentTemplate> 
<!-- controles ASP.NET o HTML para actualizar --> 
</ContentTemplate> 
</asp:UpdatePanel> 


Según lo expuesto, vamos a añadir un control UpdatePanel para que almace- 
ne el control GridView delimitado por etiquetas <ContentTemplate>: 


<asp:UpdatePanel ID="UpdatePanell" runat="server"> 
<ContentTemplate> 
<asp:GridView ID="GridView1" runat="server" 


</asp:GridView> 
</ContentTemplate> 
</asp:UpdatePanel> 


UpdatePanel tiene la capacidad de interceptar cualquier postback que se pro- 
duzca en los controles que almacena, siempre que su propiedad ChildrenAsTrig- 
gers valga true (valor predeterminado), y realizar una llamada en segundo plano 
al servidor para posteriormente recoger la respuesta y actualizar su contenido. 
Aparece el término trigger o disparador: evento que produce un postback. 


Si ahora ejecuta la aplicación y modifica sobre el propio control GridView 
alguna de sus filas, observará que ya no se recarga toda la página (observe que no 
cambia la hora mostrada por la página). Pero, si elige una opción de la lista des- 
plegable para mostrar otro contenido en el control GridView entonces sí se recar- 
ga toda la página. 


Todos los controles incluidos en un UpdatePanel actúan de forma predeter- 
minada como disparadores, si ChildrenAsTriggers vale true, por eso se actualiza 
solo el GridView cuando modificamos alguno de sus registros. Pero también se 
puede utilizar como disparador un evento producido por un control fuera del Up- 
datePanel, por ejemplo, en nuestro caso, por la lista de opciones DropDownListl. 
Esto es lo que tendremos que hacer para que al actuar sobre la lista de opciones 
solo se actualice la parte de la página correspondiente al GridView. Para ello, se- 
leccione el control UpdatePanel y modifique el valor de su colección Triggers a 
través de la ventana de propiedades. Esta acción visualizará el siguiente diálogo: 
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Haga clic en el botón Agregar para añadir al contenedor un nuevo elemento 
AsyncPostBackTrigger y configúrelo para que produzca un postback cuando la 
lista DropDownList] genere el evento SelectedIndexChanged. 


<asp:UpdatePanel 1D="UpdatePanell" runat="server"> 
<ContentTemplate> 


</ContentTemplate> 
<Triggers> 
<asp:AsyncPostBackTrigger ControlID="DropDownListl1" 
EventName="SelectedIndexChanged" /> 
</Triggers> 
</asp:UpdatePanel> 


Pruebe de nuevo la aplicación y observe que ahora, cuando elige una opción 
de la lista desplegable para mostrar otro contenido en el control GridView, solo 
se recarga la parte de la página correspondiente a la rejilla. 


Clase AsyncPostBackTrigger 


Igual que nos ocurría con la lista nos sucede con el control DetailsView. Cuando, 
utilizando este control, añadimos un nuevo registro a la rejilla, se recarga toda la 
página. Para que esto no suceda podemos proceder de las dos formas descritas a 
continuación: una, incluyendo este control en un contenedor UpdatePanel; y dos, 
agregando al contenedor de la rejilla un nuevo elemento AsyncPostBackTrigger, 
en este caso para el evento ItemInserting: 
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<Triggers> 
<asp:AsyncPostBackTrigger ControlID="DropDownListl1" 
EventName="SelectedIndexChanged"” /> 
<asp:AsyncPostBackTrigger ControlID="DetailsViewl1" 
EventName="ItemInserting" /> 
</Triggers> 





Como la segunda opción ya la hemos visto y la primera también, vamos a op- 
tar por la primera para explicar otros aspectos. Entonces, vamos a añadir un nuevo 
contenedor UpdatePanel para que almacene el control DetailsView delimitado 
por etiquetas <ContentTemplate>. 


Después, asignamos a la propiedad UpdateMode de este contenedor el valor 
Conditional para que no se actualice siempre que se produzca un postback fuera 
del mismo. Esto es, el contenido de un control UpdatePanel es actualizado en las 
siguientes circunstancias: 


e Si su propiedad UpdateMode vale Always, siempre que se produzca un post- 
back en cualquier parte de la página, dentro o fuera del contenedor. 


e Si el contenedor UpdatePanel está dentro de otro contenedor UpdatePanel 
se actualizará siempre que se actualice el contenedor padre. 


e Si la propiedad UpdateMode vale Conditional y se da una de las siguientes 
condiciones: 


o Se llama explícitamente al método Update de UpdatePanel. 
o El postback es producido por un trigger definido en el contenedor. 


o La propiedad ChildrenAsTriggers vale true y un control del contenedor 
produce un postback. En el caso de contenedores anidados, un control de 
un contenedor UpdatePanel anidado no produce una actualización en el 
panel padre excepto cuando él mismo se defina explícitamente como dis- 
parador. 


Clase UpdateProgress 


Con Extensiones AJAX solo se puede realizar una llamada asincrona al servidor 
cada vez; esto nos hace pensar que sería bueno disponer de algún modo para noti- 
ficar al usuario el estado de la llamada en curso. Con este propósito, Extensiones 
AJAX proporciona un contenedor denominado UpdateProgress. Este control al- 
macena cualquier control ASP.NET o HTML que se desee mostrar al usuario 
mientras se resuelve la llamada asíncrona; lo ideal es mostrar una imagen animada 
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que indique que un proceso se está realizando. Con un solo contenedor Update- 
Progress se puede controlar toda la actividad de los contenedores UpdatePanel 
de una página mostrando la misma información para todos ellos según se van pro- 
duciendo actualizaciones en su contenido. Si esta solución no se ajusta a nuestras 
necesidades y requerimos utilizar varios contenedores UpdateProgress, estos tie- 
nen una propiedad AssociatedUpdatePanel que permite identificar al contenedor 
UpdatePanel que se desea controlar. 


Según lo expuesto, vamos a añadir al formulario un control UpdateProgress 
encima del control GridView que nos indique cuándo este se está actualizando. 
Desde la caja de herramientas, arrastre un contenedor de este tipo encima de la re- 
jilla y escriba un simple texto “Actualizando...”, mueva una imagen animada o 
ambas cosas dentro del contenedor, pero delimitado todo ello por etiquetas <Pro- 
gressTemplate>: 


<asp:UpdateProgress ID="UpdateProgressl1" runat="server"> 
<ProgressTemplate> 
<img srec="imagenes/indicador.gif" /> 
Actualizando... </ProgressTemplate> 
</asp:UpdateProgress>» 


Ahora, cuando ejecute la aplicación y se actualice la rejilla observará encima 
de ella una imagen animada más el literal “Actualizando...”. 


Nota: si está haciendo las pruebas sobre su propia máquina y no contra un 
servidor en Internet, seguramente no verá la información mostrada por Update- 
Progress porque el tiempo empleado en la actualización es tan pequeño que no da 
lugar a mostrarla. Puede probar estableciendo un retardo cuando se produzca el 
evento ItemInserted de DetailsView. No olvide eliminar este código antes de 
poner en producción la aplicación. 
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Cancelar una llamada asíncrona 


También hemos dicho que con Extensiones AJAX solo se puede realizar una lla- 
mada asincrona al servidor cada vez; una segunda llamada asíncrona cancelaría la 
anterior que estuviera en curso. Pero ¿cómo se implementaría una opción para 
cancelar manualmente una llamada asincrona en curso? Esta operación hay que 
realizarla con un script en el lado del cliente y para ello tenemos que saber que el 
objeto PageRequestManager del espacio de nombres Sys.WebForms es el res- 
ponsable de actualizar los contenidos parciales de la página web definidos por los 
correspondientes contenedores UpdatePanel, por lo que sería suficiente obtener 
una referencia al mismo e invocar a su método abortPostBack: 


function CancelarLlamadaAsincrona() 
{ 
var objPRManager = Sys.WebForms.PageRequestManager.getInstance(); 
if (objPRManager.get_isInAsyncPostBack()) 
objPRManager.abortPostBack(); 
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La función anterior obtiene el objeto PageRequestManager a través de su 
método getInstance y, a continuación, comprueba si se está procesando una lla- 
mada asincrona (get_isInAsyncPostBack) en cuyo caso aborta dicho proceso. 


Clase Timer 


¿Ha observado cómo funciona una aplicación de correo web como, por ejemplo, 
Gmail o Outlook web Access? Es la propia aplicación la encargada de verificar 
cada cierto intervalo de tiempo si hay nuevos mensajes. Pues bien, esta verifica- 
ción también está soportada por Extensiones AJAX a través del control Timer. 


Timer es simplemente un temporizador que, al igual que otros temporizado- 
res, genera un evento, Tick en este caso, cada vez que transcurre el período de 
tiempo programado a través de su propiedad Interval, evento que podemos utili- 
zar para realizar las actualizaciones programadas a través de los contenedores 
UpdatePanel. ¿Cómo? Pues incluyendo el Timer en el contenedor UpdatePanel, 
o bien no incluirlo y utilizar un disparador para vincular el evento Tick con un 
contenedor UpdatePanel o en el código del servidor a través de la propiedad Up- 
date de UpdatePanel. En Ejercicios resueltos veremos un ejemplo. 


Servicios web 


Una de las funcionalidades más interesantes incluidas en Microsoft AJAX Library 
es la posibilidad de llamar a servicios web. Esta facilidad nos permite llamar des- 
de el código JavaScript del lado del cliente para ejecutar código en el servidor sin 
tener que realizar un postback. 


Ahora bien, para que un servicio web pueda ser invocado a través de Micro- 
soft AJAX Library ha de cumplir ciertos requisitos: 


1. El servicio web tiene que ser local al dominio de ejecución de la página que lo 
invocará, esto es, tendrá que agregarlo al proyecto. Esto es por seguridad, se- 
gún comentamos en el apartado XMLHttpRequest al hablar de “llamadas 
fuera de dominio”. 


Nota: para invocar a un servicio web de terceros se puede crear en el servidor 
un servicio web que actúe como intermediario (un proxy). 


2. El servicio web debe especificar, además del atributo ServiceContract, el 
atributo AspNetCompatibilityRequirements del espacio de nombres Sys- 
tem.ServiceModel.Activation (incluya la directriz using correspondiente). 
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3. La página que utilice el servicio web debe añadir una referencia al mismo en 
el control ScriptManager. Puede añadir dicha referencia bien a través de su 
colección Services o escribiendo código HTML. 


Finalmente, para invocar a un método expuesto por el servicio web hágalo 
desde JavaScript creando un objeto de la clase del servicio: 


var servicio = new EspacioDeNombres.ClaseServicioWeb(); 
servicio.Método( argumentos); 


La llamada se hace a través de un proxy que se genera en JavaScript al añadir 
a la página la referencia al servicio web. 


Veamos un ejemplo sencillo. Vamos a crear un sitio web con una página web 
basada en AJAX que muestre en una etiqueta el mensaje “Hola mundo” con color 
y tamaño aleatorios cada vez que el usuario haga clic en un botón. Esta acción 
no recargará toda la página, solo actualizará la etiqueta. El mensaje será devuelto 
por una llamada a un método de un servicio web. 


Para empezar, cree un nuevo sitio web igual que lo hizo anteriormente. Lo 
vamos a denominar, por ejemplo, ServicioWebAJAX. Después, añada al formula- 
rio una página Default.aspx con una etiqueta HTML y un botón HTML. 


<form id="forml" runat="server"> 
<asp:ScriptManager ID="ScriptManager1" runat="server" /> 
<div> 
<input id="btMensaje" type="button" value="Haga clic aquí" /> 
<br /><br /> 
<label id="etMensaje" /> 
</div> 
</form> 


Observe que la página tiene un control ScriptManager. Este control será el 
que almacenará una referencia al servicio web que crearemos a continuación. 


Vamos a añadir al proyecto un servicio web (clic con el botón secundario del 
ratón sobre el nombre del proyecto > Agregar nuevo elemento > Servicio WCF 
con AJAX habilitado). Complete el servicio web como se muestra a continuación. 


Si especifica un espacio de nombres debe indicarlo también en el atributo 
Class de la directriz WebService en el fichero .asmx. El ejercicio completo lo 
puede obtener de la carpeta Servicio WebAJAX. 


<%@ ServiceHost Language="C¿f" Debug="true" Service="Service” 
CodeBehind="-/App_Code/Service.cs” %> 
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using System.ServiceModel ; 
using System.ServiceModel.Activation; 


[ServiceContract (Namespace = "ServicioWebAJAX")] 
[AspNetCompatibilityRequirements( 

RequirementsMode = AspNetCompatibilityRequirementsMode.Allowed)] 
public class Service 


( 





[OperationContract] 
public string Saludo() 
{ 

return "Hola a todos"; 


} 


Observe que hemos introducido justo antes de la declaración de la clase el 
atributo [AspNetCompatibilityRequirements] perteneciente al espacio Sys- 
tem.ServiceModel.Activation. Este atributo permite habilitar el modo de compa- 
tibilidad de ASP.NET para que el servicio participe en la canalización HTTP de 
ASP.NET de una manera similar a los servicios ASMX. 


Una vez finalizado el servicio web, pasamos a desarrollar la parte correspon- 
diente al lado del cliente, desde la que invocaremos a este servicio. 


¿Cómo se invoca al servicio web? Lo primero que haremos será añadir una 
referencia al mismo en el control ScriptManager. Dicha referencia se correspon- 
de con la ruta donde se localiza el servicio. Esto puede hacerlo a través de su pro- 
piedad Services: 


<asp:ScriptManager ID="ScriptManagerl" runat="server" > 
<Services> 
<asp:ServiceReference Path="Service.svc" /> 
</Services> 
</asp:ScriptManager> 


De esta forma, ScriptManager generará un proxy a través del cual podremos 
acceder a los métodos del servicio web. 


A continuación, añadiremos una función JavaScript que invoque al servicio 
web. Para ello, añada al proyecto un nuevo elemento de tipo JScript, denominado 
funciones.js, para almacenar esta y otras funciones. 


function InvocarServicioWeb() 


( 
var servicio = new ServicioWebAJAX.Service(); 


servicio.Saludo(Mensaje); 


1 
J 
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Esta función invoca al método Saludo del servicio web de la clase Service 
perteneciente al espacio de nombres ServicioWebAJAX. Hay que destacar que la 
llamada se está haciendo desde el lado del cliente y que el método, en este caso 
Saludo, añade a los argumentos que tenga uno más correspondiente al nombre de 
la función en el lado del cliente que será invocada automáticamente cuando finali- 
ce la llamada asíncrona. Ésta es una función JavaScript que tiene un parámetro pa- 
ra recibir el resultado. Para nuestro ejemplo, se llama Mensaje y sería así: 


function Mensaje(resultado) 
( 
var etiqueta = $get("etMensaje"); // $get = document .getElementByld 
var tamanyo = numero_aleatorio(4, 7); 
var color = color_aleatorio(); 
etiqueta. innerHTML = "<FONT SIZE=*"" + tamanyo + "* COLOR="" + 
color + "*>1n" + resultado + "An</FONT>1n"; 





Observamos que la función de retorno, Mensaje, recibe en su parámetro, re- 
sultado, el resultado obtenido por medio de la llamada al servicio web. Por otra 
parte, hay que aclarar que la llamada $get es un atajo de document.getElement- 
Byld. 


Generalizando, podemos decir que es posible pasar argumentos a los métodos 
del servicio web (cuando estos tienen parámetros) y usar métodos de devolución 
de llamada (callback) para la actualización de los elementos del explorador. Tam- 
bién podemos pasar referencias a tres métodos de devolución de llamada que se- 
rán llamados cuando el servicio web devuelva la respuesta. La sintaxis sería así: 


<script type="text/javascript"> 
function js() 
( 
var servicio = new EspacioDeNombres.ClaseServicioWeb(); 
servicio.Metodo([argumentos], SiExito, SiFracaso, SiErrorTiempoDeEspera); 
) 


function SiExitolresultado, contextoActual, nombreMetodo) 
( 


) 


function SiFracasolresultado, contextoActual, nombreMetodo) 
( 


alert("Error"); 


alertí(resultado._message); 
) 
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function SiErrorTiempoDeEspera([argumentos]) 
( 


) 
</script> 


Finalmente, ¿quién llama a la función que invoca al servicio web?, esto es, a 
InvocarServicioWeb. Pues esta función tiene que ser invocada cada vez que el 
usuario haga clic en el botón, instante en el que se genera su evento onclick. Se- 
gún esto, modifique el código HTML que define el botón así: 


<input id="btMensaje" type="button" value="Haga clic aquí" 
/> 


Para que las funciones JavaScript almacenadas en el fichero funciones.js pue- 
dan ser invocadas desde una página, tiene que añadir a la cabecera de la misma, 
en nuestro caso a Default.aspx, la línea siguiente: 


<script language="javascript" src="funciones.js"></script> 


Ejecute la aplicación y observe que cada vez que hace clic en el botón solo se 
modifica la etiqueta, esto es, no se recarga toda la página. 


Métodos de página 


Cuando la utilización de servicios web resulta complicada, hay una alternativa 
sencilla y cómoda, que es utilizar métodos de página: PageMethods. El compor- 
tamiento de estos métodos es análogo al de los servicios web con la diferencia de 
que, siendo métodos que se ejecutan en el servidor, pertenecen a la propia página 
.aspx en la que se desean utilizar, y, al igual que los métodos de los servicios web, 
serán invocados desde el código JavaScript del lado del cliente. 


Como ejemplo, realicemos una aplicación similar a la anterior. La vamos a 
denominar, por ejemplo, MetodosPagAJAX. Ahora, la página web basada en 
AJAX solicitará el nombre al usuario y responderá con un saludo personalizado. 


Igual que en el apartado anterior, cree un nuevo sitio web. Después, añada al 
formulario una página Default.aspx con una caja de texto HTML, un botón 
HTML y una etiqueta HTML. 


<form id="form2" runat="server"> 
<asp:ScriptManager ID="ScriptManager1" runat="server" /> 
<div> 
Nombre:&nbsp;<input type="text" id="nombre" /> 
<input id="btMensaje" type="button" value="Haga clic aquí" /> 
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<br /><br /> 
<label id="etMensaje" /> 
</div> 
</form> 


Observe que la página tiene un control ScriptManager. Este control será el 
que a través de su propiedad EnablePageMethods habilitará los métodos de pá- 
gina. El ejercicio completo lo puede obtener de la carpeta MetodosPagAJAX. 


A continuación añadiremos en el fichero de código subyacente de la página 
.aspx los métodos de página. En nuestro caso añadiremos el método siguiente: 


[WebMethod] 
public static string Saludo() 
( 


return "Hola " + nombre + Bienvenido a este sitio web."; 


) 


Observamos que hemos introducido justo antes de la declaración del método 
el atributo [WebMethod] perteneciente al espacio System.Web.Services. Este 
atributo indica que el método es un método del servidor y hace saber así al control 
SeriptManager que el cliente podrá invocarlo utilizando JavaScript. 


Así mismo, observamos también que el método es público (public) y estático 
(static). Lo primero es obvio, puesto que ScriptManager necesitará establecer 
una correspondencia en el cliente y, para ello, deberá acceder mediante reflexión a 
sus propiedades, y lo segundo también, puesto que la llamada al mismo no se 
efectuará desde un objeto de la clase, imposible de obtener en el cliente. 


Una vez finalizada la implementación de los métodos de página, pasamos a 
desarrollar la parte correspondiente al lado del cliente, desde la que invocaremos a 
estos métodos. 


¿Cómo se invoca a un método de página? Lo primero que haremos será asig- 
nar a la propiedad EnablePageMethods del control ScriptManager el valor 
True para habilitar los métodos de página. Esto puede hacerlo a través de la ven- 
tana de propiedades: 


<asp:ScriptManager ID="ScriptManagerl" runat="server" 
/> 


De esta forma, ScriptManager generará la infraestructura que se necesita pa- 
ra utilizar de forma directa esta funcionalidad. 
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A continuación añadiremos una función JavaScript que invoque al método 
página. Para ello, añada al proyecto un nuevo elemento de tipo JScript, denomi- 
nado funciones.js, para almacenar esta y otras funciones. 


function InvocarMetodoPag() 
( 
PageMethods.Saludo($get("nombre").value, Mensaje); 


1 
$ 


Esta función invoca al método página Saludo del servidor. Hay que destacar 
que la llamada se está haciendo desde el lado del cliente y que el método, en este 
caso Saludo, añade a los argumentos que tiene uno más correspondiente al nom- 
bre de la función en el lado del cliente que será invocada automáticamente cuando 
finalice la llamada asincrona. Ésta es una función JavaScript que tiene un paráme- 
tro para recibir el resultado. Para nuestro ejemplo, se llama Mensaje y sería así: 


function Mensaje(resultado) 
( 
var etiqueta = $get("etMensaje"); // $get = document .getElementByld 
var tamanyo = numero_aleatorio(4, 7); 
var color = color_aleatorio(); 
etiqueta. innerHTML = "<FONT SIZE=*"" + tamanyo + "* COLOR="" + 
color + "*>1n" + resultado + "\n</FONT>\n"; 





Finalmente, ¿quién llama a la función que invoca al método de página?, esto 
es, a InvocarMetodoPag. Pues esta función tiene que ser invocada cada vez que el 
usuario haga clic en el botón, instante en el que se genera su evento onclick. Se- 
gún esto, modifique el código HTML que define el botón así: 


<input id="btMensaje" type="button" value="Haga clic aquí” 
[2 


Para que las funciones JavaScript almacenadas en el fichero funciones.js pue- 
dan ser invocadas desde una página, tiene que añadir a la cabecera de la misma, 
en nuestro caso a Default.aspx, la línea siguiente: 


<script language="javascript" src="funciones.js"></script> 


Este código resulta más sencillo que su homólogo implementado con servi- 
cios web y los resultados son exactamente los mismos. Ejecute la aplicación y ob- 
serve que cada vez que hace clic en el botón solo se modifica la etiqueta, esto es, 
no se recarga toda la página. 
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EJERCICIOS RESUELTOS 


La hora que muestra la página web de la aplicación anterior solo cambia cuando 
se recarga toda la página. Vamos a modificar este comportamiento para que la pá- 
gina muestre en todo instante la hora actual sin que esto suponga recargar toda la 
página, sino solo la parte que muestra la hora. Para ello, vamos a utilizar tres con- 
troles de servidor de Extensiones AJAX. SeriptManager, UpdatePanel y Timer. 
Añadiendo estos controles a la página, se elimina la necesidad de tener que refres- 
car toda la página por cada postback que se genere para actualizar la hora. 


Cargue el proyecto anterior (SitioWebAJAX) y muestre la página MasterPa- 
ge.master. Esta página ya tiene un control SeriptManager. A continuación, desde 
la caja de herramientas añada un contenedor UpdatePanel y después incluya den- 
tro de este un control Label, para mostrar la hora, y un control Timer que genere 
un evento OnTick cada segundo (propiedad Interval igual a 1000 ms): 


<body> 
<form id="forml" runat="server"> 
<asp:ScriptManager ID="ScriptManager1" runat="server"> 
</asp:ScriptManager> 
<div> 
<img src="imagenes/ceballos.png" width="120" /> 
<p><script>hora()</script> 
<asp:UpdatePanel ID="UpdatePanell" runat="server"> 
<ContentTemplate> 
<asp:Label ID="etHora" runat="server" Text="Label" 
Font-Bold="True" Font-Names="Arial" Font-Size="X-Large"> 
</asp:Label> 
<asp: Timer 1ID="Timer1" runat="server" Interval="1000" 
OnTick="Timerl1_Tick"> 
</asp:Timer> 
</ContentTemplate> 
</asp:UpdatePanel> 
</div> 


























En este ejemplo, el intervalo del temporizador es de 1 segundo. Esto supone 
que cada segundo se producirá un postback que será interceptado por el control 
UpdatePanel que realizará una llamada asíncrona al servidor para obtener la in- 
formación que actualizará la hora mostrada por la etiqueta etHora. Para ello, aña- 
da en el fichero MasterPage.master.cs el método que responda al evento OnTick 
del temporizador y complételo como se indica a continuación: 
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protected void Timerl_Tick(object sender, EventArgs e) 
( 
Label1.Text 
etHora.Text 


"Hora actual:"; 
DateTime.Now.ToString("h:mm:ss tt", 
DateTimeFormatIinfo.Invariantinfo); 





En una aplicación en producción debería establecer el intervalo lo más grande 
posible, por ejemplo para que la hora cambie cada minuto para reducir el tráfico 
de red y el trabajo realizado por el servidor. 


Cuando ejecute la aplicación observará que la hora cambia cada segundo 
mientras que la hora que ya presentaba la página en versiones anteriores no varía. 
Esto demuestra que no se está actualizando nada más que la etiqueta etHora. 


PARTE 











Acerca del CD y de los apéndices 
e Entornos de desarrollo 
e Páginas web 


e Internacionalización 


.NET para Linux 


e Índice 


APÉNDICE A 


O F.J.Ceballos/RA-MA 


HERRAMIENTAS DE DESARROLLO 


Cuando se utiliza un entorno de desarrollo integrado (EDI), lo primero que hay 
que hacer una vez instalado es asegurarse de que las rutas donde se localizan las 
herramientas, las bibliotecas, la documentación y los ficheros fuente hayan sido 
establecidos; algunos EDI sólo requieren la ruta donde se instaló el compilador. 
Este proceso normalmente se ejecuta automáticamente durante el proceso de ins- 
talación de dicho entorno. Si no es así, el entorno proporcionará algún menú con 
las órdenes apropiadas para realizar dicho proceso. Por ejemplo, en los EDI que se 
presentan a continuación las rutas a las que nos referimos quedan establecidas du- 
rante la instalación de los mismos. 


VISUAL STUDIO 


Visual Studio proporciona una variedad de herramientas tanto para desarrollado- 
res individuales como para equipos de desarrollo. 


http: //www.microsoft.com/express/ 


Ediciones Visual Studio Express 


Es la nueva línea de productos que expanden Visual Studio ofreciendo herramien- 
tas ligeras y sencillas de aprender y de usar para aficionados, entusiastas y apren- 
dices que quieren crear sitios Web y aplicaciones para Windows. Su descarga es 
gratuita y dependiendo del tipo de aplicación a desarrollar optaremos por una u 
otra herramienta de desarrollo de las siguientes: 


e Visual Studio Express for Web. 
e Visual Studio Express for Windows 8. 
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e Visual Studio Express for Windows Desktop. 
e Visual Studio Express for Windows Phone. 
e Visual Studio Team Foundation Server Express. 


Ediciones de Visual Studio para profesionales 


Visual Studio en sus versiones professional, premium y ultimate, ofrece una fle- 
xible herramienta de desarrollo para desarrolladores de aplicaciones de línea de 
negocio o programadores ocasionales que estén construyendo aplicaciones móvi- 
les, basadas en Windows o para la Web, soluciones sobre Microsoft Office Sys- 
tem utilizando Excel, Word e InfoPath, y con herramientas de software de ciclo de 
vida productivas, integradas y extensibles que permiten a las empresas reducir la 
complejidad en la creación de soluciones orientadas a servicios. La utilización de 
estas versiones requiere comprar una licencia. 


APLICACIÓN DE CONSOLA 


En el capítulo 2 vimos una introducción al desarrollo de aplicaciones con interfaz 
gráfica de usuario, pero no abordamos el desarrollo de aplicaciones de consola 
que en ocasiones puede ser útil. Veamos un ejemplo a continuación utilizando 
cualquiera de las ediciones de Visual Studio. 


Para editar y ejecutar el programa HolaMundo utilizando cualquiera de las 
ediciones de Visual Studio, los pasos a seguir son los siguientes: 


1. Partiendo de la página de inicio de MS Visual C# Express, hacemos clic en 
Nuevo proyecto... para crear un proyecto nuevo, o bien ejecutamos la orden 
Archivo > Nuevo proyecto. Esta acción hará que se visualice una ventana que 
mostrará los tipos de plantillas que puede utilizar; la elección de una u otra 
dependerá del tipo de aplicación que deseemos construir. La figura siguiente 
muestra esta ventana: 
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A 
b Redente Ordenar por: Predeterminado - Buscar en la Plantillas instalado (Ctrl+E) ¿> 
= “5 Tipo: Visual CF 

[ ] Aplicación de Windows Forms Visual C# o A 
4 Plantillas Proyecto para crear una aplicación de línea de 
b Visual Basic cs Aplicación WPF Gai comandos. 
4 Visual CF qe licación ¡su 
Windows Ce 
Prueba Aplicación de consola Visual C# 
b Visual C++ ce 
Soluciones de Visual Studio ¿y Biblioteca de dases Visual C# 
Ejemplos y 
uc s E 
b Enfínea N] Proyecto vacio Visual C# 
Nombre: HolaMundo 
Ubicación: c: \users\fjavier documents visual studio 2012}Projects ” Examinar... | 
Nombre de la solución: Crear directorio para la solución 














Agregar al control de código fuente 








[aceptar | concen | 


Para que la ventana anterior muestre la lista Ubicación y la caja Nombre de la 
solución tiene que habilitar, si no lo está, la opción “Guardar nuevos proyec- 
tos al crearlos”. Para ello, ejecute la orden Herramientas > Opciones > Pro- 
yectos y soluciones y seleccione esta opción en la ventana que se visualiza: 


cores T 
Entorno Ubicación de proyectos: 
E Proyectos y soluciones l c: \users\fjavier \documents\visual studio 2012}Projects a | 





- Ubicación de plantillas de proyecto de usuario: 

Compilar y ejecutar e = - 

Configuración de proyecto de WC! | c: users\fjavier \documents\visual studio 2012\Templates\ProjectTempla  ««. | 
Directorios de VC++ Ubicación de plantillas de elemento de usuario: 


Valores predeterminados de VB [ c: \users\fjavier \documents\visual studio 2012|Templates ltemTemplate:  ... | 


Control de código fuente 


Editor de texto ÍV Mostrar lista de errores si la compilación termina con errores 

E] Depuración FT Realizar seguimiento del elemento activo en el Explorador de soluciones 
Administrador de paquetes [Y Mostrar configuraciones de compilación avanzadas 

Diseñador de Windows Forms IV Mostrar solución siempre 

Herramientas para bases de datos [Guardar nuevos proyectos al crearlos 

pepa ¡aver al usuario cuando la ubicación jón del proyecto no sea de confianza 


[Y Mostrar ventana de salida cuando empiece la compilación 
[Y Solicitar cambio de nombre simbólico al cambiar el nombre de los archivos 








¡SE PERES] 





Para nuestro ejemplo, elegimos la plantilla “Aplicación de consola”. Después, 
especificamos el nombre del proyecto y su ubicación; observe que el proyecto 
será creado en una carpeta con el mismo nombre. A continuación pulsamos el 
botón Aceptar y obtendremos el esqueleto del proyecto de acuerdo con la 
plantilla seleccionada. Para cambiar el nombre asignado al fichero .cs, hace- 
mos clic sobre Program.cs y utilizando el botón derecho del ratón, seleccio- 
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namos del menú contextual que se visualiza la orden Cambiar nombre; tam- 


bién podemos hacer este cambio a través de la ventana de propiedades. 

















DQ HolaMundo - Microsoft Visual Studio Express 2012 para escritorio de Windows Inicio rápido (Ctri+Q) f- 0 X 
ARCHIVO EDITAR VER PROYECTO COMPILAR DEPURAR EQUIPO HERRAMIENTAS PRUEBA VENTANA AYUDA 
O- Ban 9- P Iniciar ~ Debug ~ AnyCPU - A b VO NM $ 
E | Program.cs* 2 X| v Explorador de soluciones “41x 
s s HolaMundo.Program ~ O, Main(string[] args) = 0 o-a QTD o42x * 
a - 
A using System; + = a nd es (Ctrl+ ~ 
F using System.Collections.Generic; E Buscar en el Explorador de soluciones (Ctrl+ JP 
3 using System. Ling; R] Solución 'HolaMundo' (1 proyecto) 
ñ using System. Text; a [cs] HolaMundo 
4 using System.Threading.Tasks; b Æ Properties 
e as p =m References 
a a 
E class Program b © Program.cs 
{ 
3 static void Main(string[] args) 
{ 
| 
} y Propiedades * px 
} A + 
MIES 
100% ~ 
Resultados 


nx 


Mostrar resultados desde: 











Si necesitáramos añadir un fichero nuevo a este proyecto, haríamos clic con el 
botón derecho del ratón sobre el nombre del proyecto y seleccionaríamos 
Agregar > Nuevo elemento. Después, elegiríamos el tipo de elemento que 
deseamos añadir y, finalmente, haríamos clic en el botón Agregar. 


2. A continuación editamos el código que compone el programa. Después, antes 
de compilar la aplicación, podemos verificar que se trata de una aplicación de 
consola: Proyecto > Propiedades de HolaMundo > Aplicación > Tipo de re- 
sultado > Aplicación de consola. 
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Dos] HolaMundo - Microsoft Visual Studio Express 2012 para escritorio de Windows Inicio rápido (Ctrl+Q) 2f- 0X 
ARCHIVO EDITAR VER PROYECTO COMPILAR DEPURAR EQUIPO HERRAMIENTAS PRUEBA VENTANA AYUDA 

©- Ban 9- =P Iniciar > Debug ~ AnyCPU - ABETO MN š 
E + Explorador de soluciones 4 Xx 
3“ HolaMundo.Program ~ O, Main(string[] args) - AG o0-200n ox ” 
a > 
R using System; PA IE OR E. 
z ising y Ca 2 Buscaren el Explorador de soluciones (Ctrl+ ¿2 
z using System. Ling; E] Solución 'HolaMundo' (1 proyecto) 
z using System. Text; a [©] HolaMundo 
E] using System.Threading.Tasks; b $ Properties 


D =m References 


]namespace HolaMundo A App.config 


© class Program b œ Program.cs 
5 static void Main(string[] args) 
: System.Console.Writeline(";¡¡¡Hola mundo! !!"); 
| i } Propiedades -1x 
} 
~ HE 

100% ~ 4 » 
Resultados px 
Mostrar resultados desde: Compilar > 
1>------ Operación Recompilar todo iniciada: proyecto: HolaMundo, configurac a 


1> HolaMundo -> c:\users\fjceballos\documents\visual studio 2012\Projects\H 
========== Recompilar todo: 1 correctos, € incorrectos, 0 omitidos ========= 











Operación Recompilar todo finalizada correctamente 


3. Para compilar el programa, ejecutamos la orden Generar HolaMundo del me- 
nú Generar. Finalmente, para ejecutar el programa seleccionamos la orden 
Iniciar sin depurar del menú Depurar, o bien pulsamos las teclas Ctrl+F5, 
También puede ejecutar el programa seleccionando la orden Iniciar depura- 
ción del menú Depurar, o bien pulsando la tecla F5. Los resultados de la 
compilación se muestran en la ventana Resultados. La acción de ejecutar el 
programa acarrea también su compilación si fuera necesario. 


DEPURAR UNA APLICACIÓN 


¿Por qué se depura una aplicación? Porque los resultados que estamos obteniendo 
con la misma no son correctos y no sabemos por qué. El proceso de depuración 
consiste en ejecutar la aplicación paso a paso, indistintamente por sentencias o por 
métodos, con el fin de observar el flujo seguido durante su ejecución, así como los 
resultados intermedios que se van sucediendo, con la finalidad de detectar las 
anomalías que producen un resultado final erróneo. 


Por ejemplo, para depurar una aplicación utilizando el depurador del entorno 
de desarrollo de Visual Studio, ejecute la orden Depurar > Paso por instrucciones 
y utilice las órdenes del menú Depurar o los botones correspondientes de la barra 
de herramientas (para saber el significado de cada botón, ponga el puntero del ra- 
tón sobre cada uno de ellos). 
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ED >»66 (0 4 - 





| Paso a paso por instrucciones (F11) 





De forma resumida, las órdenes disponibles para depurar una aplicación son 
las siguientes: 


e Iniciar o F5. Inicia la ejecución de la aplicación en modo depuración hasta 
encontrar un punto de parada o hasta el final si no hay puntos de parada. 


e Alternar puntos de interrupción o F9. Pone o quita un punto de parada en la 
línea sobre la que está el punto de inserción. 


e Detener depuración o Mayús+F53. Detiene el proceso de depuración. 


e Paso a paso por instrucciones o F11. Ejecuta la aplicación paso a paso. Si la 
línea a ejecutar coincide con una llamada a un método definido por el usuario, 
dicho método también se ejecutará paso a paso. 


e Paso a paso por procedimientos o F10. Ejecuta la aplicación paso a paso. Si 
la línea a ejecutar coincide con una llamada a un método definido por el usua- 
rio, dicho método no se ejecutará paso a paso, sino de una sola vez. 


e Paso a paso para salir o Mayús+F11. Cuando un método definido por el 
usuario ha sido invocado para ejecutarse paso a paso, utilizando esta orden se 
puede finalizar su ejecución en un solo paso. 


e Ejecutar hasta el cursor o Ctrl+F10. Ejecuta el código que hay entre la últi- 
ma línea ejecutada y la línea donde se encuentra el punto de inserción. 


e Inspección rápida o CtrI+Alt+0. Visualiza el valor de la variable que está ba- 
jo el punto de inserción o el valor de la expresión seleccionada (sombreada). 


Para ejecutar la aplicación en un solo paso, seleccione la orden Iniciar sin de- 
purar (Ctrl+F5) del menú Depurar. 


Además de la barra de herramientas Depurar, dispone también de la barra de 
herramientas Generar reducida que se muestra en la figura siguiente: 


Esta barra de herramientas pone a su disposición las órdenes siguientes: 


e Generar aplicación. Compila la aplicación y genera el fichero ejecutable co- 
rrespondiente. 
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e Generar solución. Compila y genera todos los proyectos que componen la so- 
lución. 


e Cancelar. Detiene el proceso de compilación o de generación del fichero eje- 
cutable. 


ARGUMENTOS EN LA LÍNEA DE ÓRDENES 


Si ejecuta una aplicación desde el EDI que requiere argumentos en la línea de ór- 
denes, ¿dónde se introducen estos argumentos? Haga clic sobre el nombre del 
proyecto con el botón derecho del ratón y seleccione la orden Propiedades. Des- 
pués, en la ventana que se visualiza, seleccione el panel Depurar y escriba los ar- 
gumentos según puede observar en la figura: 


ARES Program.cs z 
Aplicación A y a_i e n 

Configuración: |(Debug) activa v Plataforma: |(Any CPU) activa X l 

Compilar 

Eventos de compilación Opciones de inicio 


E Argumentos de la línea de comandos: | 


Recursos 





Servicios 

Configuración A 
Rutas de acceso de referencia a o lo J 
iiia 7] Habilitar depuración de código nativo 


Sı idad E j 
Aaii [V] Habilitar el proceso de hospedaje de Visual Studio 


Publicar 


Análisis de código 


CONECTAR A LOCALDB O A SQLEXPRESS 


El servidor de base de datos que se instala con Visual Studio es diferente depen- 
diendo de la versión de Visual Studio que haya instalado: 


e Si se utiliza Visual Studio 2010 se creará una base de datos SOL Express. 


e Si se utiliza Visual Studio 2012 se creará una base de datos LocalDB. Esto no 
significa que no pueda utilizar una base de datos SOL Express. 


SQL Server Express 


SQL Server 2012 Express es el motor de base de datos gratuito, potente, pero sen- 
cillo, que se integra perfectamente con el resto de productos Express. Se trata de 
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una versión aligerada de la nueva generación de SQL Server que puede descargar 
gratuitamente del sitio web de Microsoft. 


Este producto tiene el mismo motor de base de datos que toda la familia SQL 
Server y utiliza el mismo lenguaje SQL. Otra característica interesante es la movi- 
lidad de las bases de datos de un servidor a otro con XCOPY. Con esta utilidad 
podemos mover un fichero MDF de una máquina a otra a cualquier ubicación 
dentro de su sistema de ficheros, quedando la base de datos movida lista para tra- 
bajar. Para utilizar esta base de datos deberemos hacer uso de la opción Attach- 
DBFilename en la cadena de conexión, según se muestra a continuación: 


connectionString="Data Source=.1sqlexpress; Initial Catalog=; 
Integrated Security=True;AttachDBFileName=C:1bd1bd_editorial.mdf" 


La entrada Data Source especifica el servidor de base de datos que vamos a 
utilizar y AttachDBFilename, la localización del fichero de base de datos. Ob- 
sérvese que la entrada Initial Catalog está vacía. 


Para crear una base de datos utilizando SQL Server Express tiene que hacerlo 
desde la línea de órdenes (véase también el capítulo titulado Acceso a una base de 
datos). Para iniciar la consola que le permita trabajar contra el motor de base de 
datos SQL Server, localice en su instalación el fichero SOLCMD.EXE, cambie a 
ese directorio y ejecute la orden: 


SQLCMD -S nombre-del-ordenadorXSqlExpress 


Microsoft Windows [Versión 6.1.7601] 
Copyright (c) 2009 Microsoft Corporation. Reservados todos los derechos. 


C:\Users\fjceballos>cd C:\Program Files\Microsoft SQL Server\100\Tools\Binn 


C:\Program Files\Microsoft SQL Server\100\Tools\Binn>SALCMD -S localhost\SqlExpr 











Una vez iniciada la consola, puede escribir órdenes SQL a continuación del 
símbolo “>”. Para ejecutar un bloque de sentencias escriba GO. Para salir, escriba 
QUIT. Por ejemplo, el guión que muestra la figura siguiente crea la base de datos 
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tfnos con una tabla telefonos, añade tres filas a la tabla y, finalmente, selecciona 
todas las filas de la tabla con todas sus columnas: 


CREATE DATABASE bd_telefonos 
GO 


USE bd_telefonos 
GO 
cambió el contexto de la base de datos a 'bd_telefonos'. 


CREATE TABLE telefonos 
( 
nombre VARCHAR(30) NOT NULL, 
direccion VARCHAR(30) NOT NULL, 
telefono VARCHAR(12) PRIMARY KEY NOT NULL, 
observaciones VARCHAR( 240) 


GO 


INSERT INTO telefonos 
VALUES ('Leticia Aguirre Soriano', 'Triana, Sevilla', '954345678', 'Ni 


4> INSERT INTO telefonos 
5> VALUES ('Pedro Aguado Rodríguez’, 'Alcalá de Henares, Madrid', '918888 
888', 'Ninguna') 





Para ver la relación de órdenes que puede utilizar a través de la aplicación 
SQLCMD ejecute la orden help como se muestra en la figura siguiente. Obsérvese 
que cada orden va precedida por dos puntos (:). 


ex SQLCMD | [Of x 


¡NArchivos de programaWMicrosoft SQL Server?BxToo1sXBinn>sqlemd -S .Nsqlexpres 


— Executes a command in the Windows command shell. 
¿connect serverixinstancel [-1 timeout] [-U user [-P passwordll 

a Connects to a SQL Server instance. 
ze 

— Edits the current or last executed statement cache. 
zerror <dest> 

— Redirects error output to a file, stderr, or stdout. 
žexit 

— Quits sqlemd immediately. 
zexit©O 

— Execute statement cache; quit with no return value. 
zexit(<query>> 

ro the specified query; returns numeric result. 
o n 

— Executes the statement cache <n times). 
žhelp 

— Shows this list of commands. 
3list 

— Prints the content of the statement cache. 
:listuar 
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SQL Server 2012 Express LocalDB 


Microsoft SQL Server 2012 Express LocalDB es un modo de ejecución de SQL 
Server Express destinado a los desarrolladores de programas con el fin de sustituir 
la característica de instancias de usuario de SQL Server Express, que ha quedado 
obsoleta. La instalación de LocalDB copia un conjunto de archivos mínimo nece- 
sario para iniciar el motor de base de datos de SQL Server. Una instancia de SQL 
Server Express LocalDB se puede administrar con la herramienta de línea de ór- 
denes SqlLocalDB.exe. 


SQL SERVER MANAGEMENT STUDIO EXPRESS 


Si instaló SQL Server, habrá comprobado que no dispone de una herramienta de 
administración de bases de datos. Por tal motivo, Microsoft también ha desarro- 
llado una nueva aplicación para gestionar bases de datos que puede obtener de 
forma gratuita de Internet en la dirección especificada a continuación: 


http://www.microsoft.com/es-es/downloads 


Esta aplicación presenta una interfaz gráfica, muy sencilla de utilizar, para 
realizar tareas típicas como crear bases de datos, gestionar las tablas de la base, 
los procedimientos almacenados, crear usuarios, etc. 


Cuando inicie SOL Server Management Studio Express, le serán solicitados el 
nombre del servidor de bases de datos, el tipo de autenticación, y el usuario y la 
contraseña sólo si eligió autenticación SQL Server: 





ad Conectar con el servido 
Microsoft" 
e SQL Server2012 





Tipo de servidor: Í Motor de base de datos 





| Nombre del servidor: \sqlexpress 





[Autenticación de Windows 





ficeballos-PC'fjceballos 





EN Cancelar J Ayuda || Opciones >> 








Una vez realizada la conexión con el gestor de bases de datos, le será mostra- 
da la ventana de la figura siguiente. Seleccione en la lista del panel de la izquierda 
la base de datos con la que desea trabajar, haga clic en el botón Nueva consulta de 
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la barra de herramientas y, después, escriba en el mismo las sentencias SQL que 
desee ejecutar. Para ejecutar una sentencia SQL haga clic en el botón Ejecutar de 
la barra de herramientas. 





r - 
Ba SQLQuery2.sql - (local)isqlexpress.master (fjceballos-PC\fjceballos (53))* - Microsoft SQL Server Management Studio Sro 





Archivo Editar Ver Consulta Proyecto Depurar Herramientas Ventana Ayuda 
dr d a id g | Nueva consulta X oD DlA a aa al» 
E 2 A | [master -|| Y Becutar P Depurar = v 33 al O) 
Explorador de objetos 2LQuery2.sq! - (lo...-PC y (53) 
Conectar» 3 9 a 761.4 select * from bd_telefonos.dbo.telefonos 
a É bd_telefonos 
e @ Diagramas de base de datos 
e Ca Tablas 
@ @ Tablas del sistema 
@ a FileTables 
a 3 dbo.telefonos 
E [a Columnas 
El nombre (varchar(30), No NUI E 
[E] direccion (varchar(30), No NU! 
? telefono (PK, varchar(12), No 
El observaciones (varchar(240), | direccion telefono observaciones 
a EA Claves i | Boston, U.S.A. 111555999 CEO Evemedia 
a Restricciones Isabella Ceballos González Boston, U.S.A. 123456789 La más grande 
Javier Ceballos Femández Alcalá de Henares, Madd 911234567 Ingeniero de Informática 


Roberto Canales Mora Torrejón, Madrid 916753306 Director ejecutivo de Autentiz 
Pedro Aguado Rodríguez Alcalá de Henares, Madid 918888888 Ninguna 





m [A Desencadenadores 
E Ea Índices 


mm Y Estadísticas Alfons González Pérez Argentona, Barcelona 933333333 Director de desarrollo 
@ Ea Vistas — Ismael Puertas López Mataró, Barcelona | 934343567 _ Frabicante de calzado 
Í Ea Sinónimos [ m 





E E EY E 


a 
Resultados 


Mostrar resultados desde: Generar -|| ə | 4) 3 K | Le 








Col 41 














CREAR UNA BASE DE DATOS 


Si no instaló SQL Server 2012 Express puede crear una nueva base de datos local 
al proyecto siguiendo los pasos especificados a continuación. Haga clic con el bo- 
tón secundario del ratón sobre el nombre del proyecto para agregar un nuevo ele- 
mento y seleccione Base de datos basada en servicio. A continuación se abrirá el 
asistente para la configuración de orígenes de datos y, como no hay ningún objeto 
de base de datos disponible porque la base de datos es nueva, haga clic en Cance- 
lar para crear y agregar la base de datos vacía al proyecto. A continuación puede 
continuar añadiendo las tablas, los datos de las tablas, las relaciones entre las ta- 
blas, etc. Puede ver un ejemplo en el apartado Ejercicios resueltos del capítulo 
Acceso a una base de datos. 


Si instaló SQL Server 2012 Express (nombre predeterminado del servidor: 
sqglexpress), entonces es posible añadir al proyecto elementos nuevos de tipo base 
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de datos utilizando el explorador de bases de datos. Para ello, abra el Explorador 
de bases de datos (Ver > Otras ventanas > Explorador de bases de datos). Haga 
clic con el botón secundario del ratón sobre el nodo Conexiones de datos y selec- 
cione Agregar conexión. Elija como origen de datos Microsoft SOL Server. Se vi- 
sualizará la ventana siguiente: 





18 
Agregar conexión 





Especifique la información para establecer conexión con el origen de datos 
seleccionado o haga clic en "Cambiar" para elegir un origen y/o un 
proveedor de datos diferente. 


Origen de datos: 


Microsoft SQL Server (SqlClient) 


Nombre del servidor: 


Conexión con el servidor 


(9) Usar autenticación de Windows 


© Usar autenticación de SQL Server 


Guardar mi contraseña 


Establecer conexión con una base de datos 


(9) Seleccione o escriba el nombre de la base de datos: 


bd telefonos X 


Asociar con un archivo de base de datos: 


f Examinar. 


| Aceptar || Cancelar | 























Escriba el nombre de la base de datos y haga clic en Aceptar. Se visualizará el 
mensaje La base de datos “bd_telefonos” no existe. ¿Desea intentar crearla?: 





r m My 
Microsoft Visual Studio Express 2012 para escritorio de Windows [e 





O La base de datos 'bd_telefonos' no existe o no tiene permiso para verla, 


¿Desea intentar crearla? 





Lata) [ecc] 


=d 

















Haga clic en Sí. Observará en el explorador de bases de datos que 
bd _telefonos ha sido creada. 
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El paso siguiente es añadir las tablas. Despliegue el árbol correspondiente a la 
nueva conexión, haga clic con el botón secundario del ratón sobre el nodo Tablas 
y agregue una nueva tabla. Después complete el proceso de creación de la misma. 





Y Progam zs 








schivo de script: dbo. Table.sql 
Tipo dedstos Permitir valores NULL Predeterminado 4 Claves (1) 
int <sin nombre> (Clave principal, Clustered: Id) 
Restricciones CHECK (0) 
Índices (0) 
Claves externas (0) 
Desencadenadores (1) 


Q Diseñar Y - STA onm 
CREATE TABLE [dbo]. [Table] + 


[14] INT PRIMARY KEY 


wo% - 
e) Conexión lista ¡Asqlespress | WIN-SODF77OMECBficeba... | bd_telefonos 


Puede ver un ejemplo de este proceso en el apartado Ejercicios resueltos del 
capitulo Acceso a una base de datos. 


INSTALACIÓN DE ASP.NET EN WINDOWS 


ASP.NET queda instalado automáticamente cuando instaló Visual Studio o, en su 
defecto, Visual Studio Express for Web. Ahora bien, para crear y ejecutar aplica- 
ciones para Internet necesitará un servidor de aplicaciones, en el caso de la plata- 
forma Windows éste es IIS (Internet Information Server). La instalación de IIS 
debe ser anterior a la de NET Framework. Si no se hizo asi, ASP.NET no estará 
habilitado en IIS y no podremos realizar aplicaciones ASP.NET. En este caso, la 
solución es registrar manualmente ASP.NET en IIS. 


Registro manual de ASP.NET en IIS 


Para registrar manualmente ASP.NET en IIS, abra una ventana de consola, sitúese 
en la carpeta C:.IWINDOWS Microsoft.NET|Frameworklvx.x.xxxxx y ejecute: 


aspnet_regiis.exe -1 -enable 
Esto habilitará IIS para la ejecución de ASP.NET, registrará las extensiones 


de ASP.NET (aspx, amsx, asax, etc.) y ya podremos empezar a trabajar con 
ASP.NET. 
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Si echa una ojeada a todas las opciones disponibles (aspnet_regiis.exe -help) 
podrá observar algunas muy interesantes, como -c, que instala las secuencias de 
órdenes del cliente de esta versión en el subdirectorio aspnet client de todos los 
directorios de sitios IIS. 


Si la operación anterior no solucionó el problema, pruebe a reparar la instala- 
ción actual a partir del CD de instalación del producto. Si esto tampoco soluciona- 
ra el problema, sólo queda desinstalar el producto y volverlo a instalar. 


DEPURAR CÓDIGO JAVASCRIPT 


En una aplicación ASP.NET que incluya código JavaScript (véase el capítulo 20) 
es posible utilizar el depurador de Visual Studio o de Visual Web Developer para 
depurar ese código. 


Para poder depurar código JavaScript, el primer paso es habilitar esta opción 
en el navegador. En el caso de Internet Explorer, seleccione Herramientas > Op- 
ciones de Internet > Opciones avanzadas y asegúrese de que no esté seleccionada 
la opción “Deshabilitar la depuración de scripts”: 


Opciones de Internet 


General Seguridad Privacidad Contenido 


Conexiones | Programas Opciones avanzadas 
( i J 


Configuración 


=Æ] Examinar A 
Cerrar las carpetas que no estén en uso en Historial y Fav 
Comprobar automáticamente si hay actualizaciones de Int 
Deshabilitar la depuración de scripts (Internet Explorer) 
Deshabilitar la depuración de scripts (otros) 

[C] Exigir la composición fuera de pantalla, inclusivo en Termir 
Habilitar el menú Favoritos personalizado 

Habilitar estilos visuales en botones y controles de página: 
Habilitar extensiones de explorador de terceros* 

Habilitar la vista de carpetas para FTP (fuera de Internet | 
Habilitar transiciones de página 

Iniciar accesos directos en ventanas ya abiertas (cuando | 
Mostrar mensajes de error HTTP descriptivos 

Mostrar una notificación sobre cada error de script 



























































IEEE 














< 
* Se aplicará cuando se reinicie Internet Explorer 





Restaurar configuración avanzada ] 





Restablecer configuración de Internet Explorer 


Elimina todos los archivos temporales, deshabilita 

los complementos del explorador y restablece 
cualquier configuración cambiada. 

Use esta opción sólo si el explorador está en un estado inutilizable. 








Í Aceptar Cancelar Aplicar 





Cumplido el requisito anterior, sólo queda poner en el código JavaScript a de- 
purar la sentencia debugger. De esta forma, cuando inicie la depuración de la 
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aplicación y el flujo de ejecución pase por esta sentencia, la ejecución se detendrá 
y podrá continuarla paso a paso. 


function CargarTabla(resultado, contexto) 
( 
debugger; 
var elementos = 
LoadXmlFromString(resultado).getElementsByTagName("string"); 
TablaResultados = document.getElementById("TablaDeResultados"); 
if (TablaResultados != null) 
{ 
Pl 


DESARROLLO 


Para el desarrollo de una aplicación, lo habitual es crear un modelo de clases si- 
guiendo algún patrón, por ejemplo el patrón de arquitectura de software Model- 
View-ViewModel (MVVM) utilizado por WPF y Silverlight, que es un sucesor del 
ampliamente conocido Model-View-Controller (MVC) utilizado por ASP.NET 
MVC, nacido del entorno Smalltalk a finales de los años 70. 


En MVC la aplicación se compone de tres tipos de objetos que tienen respon- 
sabilidades distintas con el objetivo de separar la capa visual de su correspondien- 
te programación y acceso a datos: 


e El modelo. Es el responsable de los datos y de la lógica de negocio de la apli- 
cación. 

e La vista. Es el responsable de mostrar los datos al usuario y de permitir su ma- 
nipulación desde y hacia el modelo. 

e El controlador. Es el responsable de implementar las respuestas a los eventos 
o acciones de los usuarios e invocar peticiones al modelo y probablemente a la 
vista. 


Controller 
(Controlador) 


View Model 
(Vista) (Modelo) 


Con el modelo MVC cada tipo de objeto es responsable de una cosa, lo que 
simplifica el desarrollo, comprensión y la realización de pruebas del código fuen- 
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te. Además, es fácil remplazar las vistas, o tener más de una actuando sobre los 
mismos datos. 


En el caso de las aplicaciones Silverlight, el NET Framework dispone de la 
capacidad de usar enlaces (bindings) para transferir directamente datos desde el 
controlador hacia la vista, por lo que el controlador solo es responsable de imple- 
mentar el comportamiento de esta. En este caso, el controlador se denomina mo- 
delo de vista (view model), dando origen al patrón MVVM donde: 


e El modelo. Representa los datos o información con la que se trabaja y en la 
mayoría de los casos la lógica de negocio asociada. Debe encontrarse comple- 
tamente aislado de la interfaz de usuario. 

e La vista. Representa la información en la interfaz de usuario y es capaz de 
aceptar la entrada de datos del usuario a través de controles, teclado, ratón u 
otros elementos en forma de controles desde la interfaz gráfica. 

e El modelo-vista. Objeto que separa y aísla completamente a la vista del mode- 
lo, se puede pensar en este tipo de objetos como una abstracción de la vista, 
que además hace las funciones de intermediario, transformando los datos reci- 
bidos del modelo en datos aptos para la vista y viceversa. 





pa 


View Madel | 
(Modelo Vista) 
View Model 
(Vista) (Modelo) 


Por lo tanto MVVM comparte todos los beneficios de MVC, pero con una 
ventaja adicional: la simplificación que resulta de usar enlaces declarativos para 
transferir los datos desde y hacia el modelo a la vista. 

















APÉNDICE B 


O F.J.Ceballos/RA-MA 


PÁGINAS WEB 


¿Quién no ha oido hablar de Internet? La respuesta es evidente, porque donde 
quiera que esté oirá hablar de Internet. ¿Por qué? Porque hoy en día forma parte 
del mundo de los negocios y del comercio, aunque en sus inicios no fue ésta la in- 
tención. Hay muchas empresas que le proporcionan conexión las 24 horas del día 
por un precio asequible. Pero, ¿qué es Internet?, ¿qué servicios ofrece? 


¿QUÉ ES INTERNET? 


Internet, es decir, inter-red, es una red de redes informáticas distribuidas por todo 
el mundo que intercambian información entre sí mediante la familia de protocolos 
TCP/IP. Puede imaginarse Internet como una gran nube con ordenadores conecta- 
dos: 









































Servidor 








Cliente 


Internet surgió de un programa de investigación realizado por la Agencia de 
Proyectos de Investigación Avanzados de Defensa (DARPA) de los Estados Uni- 
dos sobre la conexión de redes informáticas. El resultado fue ARPANet (1969). 
Esta red crece y a principios de los años 80 se conecta con CSNet y MILNEet, dos 
redes independientes, lo que se considera como el nacimiento de Internet (/nter- 
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national Network of computers). También forman parte de esta red NSI (NASA 
Science Internet) y NSFNet (National Science Foundation Net). 


Durante muchos años Internet ha servido para que muchos departamentos de 
investigación de distintas universidades distribuidas por todo el mundo pudieran 
colaborar e intercambiar información. Sólo recientemente ha comenzado a formar 
parte de los negocios y de nuestra vida cotidiana. 


Internet ha hecho que el mundo empresarial se haya replanteado sus sistemas 
de comunicación internos y externos y en la mayoría de los casos los haya encau- 
zado vía Internet. Esto ha dado lugar a dos subpoblaciones dentro de Internet: in- 
tranets y extranets. 


Intranet 


Una intranet no es más que una red local que utiliza los mismos protocolos que 
Internet, independientemente de que esté o no conectada a Internet. ¿Qué ventajas 
tiene una intranet? Fundamentalmente dos: independencia de los proveedores ha- 
bituales de soluciones y una única forma de trabajar que evita tener que aprender 
sistemas nuevos, lo que redunda en un ahorro de formación. Por otra parte, una 
intranet suele estar dotada de una velocidad bastante mayor que la habitual en In- 
ternet, lo que posibilita una comunicación muy fluida, incluso, cuando se trata de 
flujos de información multimedia. 


Terminología Internet 


Desde el punto de vista físico, Internet no es una simple red, sino miles de redes 
informáticas que trabajan conjuntamente bajo los protocolos TCP/IP (Transmision 
Control Protocol/Internet Protocol - Protocolo de Control de Transmisiones/Pro- 
tocolo Internet), entendiendo por protocolo un conjunto de normas que regulan la 
comunicación entre los distintos dispositivos de una red. Desde el punto de vista 
del usuario, Internet es una red pública que interconecta universidades, centros de 
investigación, servicios gubernamentales y empresas. 


El conjunto de protocolos de Internet está compuesto por muchos protocolos 
relacionados con la asociación formada por TCP e IP y relacionados con las dife- 
rentes capas de servicios de la red; esto es, las funciones de una red se pueden 
agrupar en capas de servicios de la red. Imagínese las capas como distintas esta- 
ciones por las que debe pasar un paquete de información cuando realiza la ruta de 
un ordenador a otro conectados a diferentes puntos dentro de Internet. Por ejem- 
plo, el protocolo TCP/IP visto desde este punto de vista puede imaginárselo de 
forma resumida así: 
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Aplicación 


API de Windows Sockets 
Transporte 
(TCP y UDP) 


Red 
(IP) 
Enlace 
(controlador de dispositivo, tarjeta de red, protocolos de control de la línea) 





Entre dos capas puede haber una interfaz de programación (API) para inter- 
pretar los mensajes o paquetes a medida que van pasando. 


Utilizar una interfaz de programación, como la API de Windows Sockets, li- 
bera al programador de tratar con detalles de cómo se pasan los paquetes de in- 
formación entre las capas inferiores. 


Las capas de enlace y de red se encargan de empaquetar la información y de 
llevar los paquetes de un lugar a otro de la red. ¿Cómo se identifican estos luga- 
res? La respuesta es con direcciones de Internet que permitan identificar tanto el 
ordenador como el usuario, ya que un mismo ordenador puede tener dados de alta 
diferentes usuarios. Estas direcciones son especificadas según un convenio de sis- 
tema de nombres de dominio (DNS). 


Un DNS tiene el formato siguiente: 
[subdominio].[subdominio].[...].dominio 
Por ejemplo: 
uni.alcala.es 


En este ejemplo, es es el dominio, alcala es un subdominio de es, y uni un 
subdominio de alcala. Algunos dominios de nivel superior son: 


Dominio Cobertura 

com organizaciones comerciales 

edu instituciones educativas 

net suministradores de servicios de red 
us Estados Unidos 

de Alemania 


es España 
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Cada nombre de dominio se corresponde con una única dirección de Internet 
o dirección IP. Una dirección IP es un valor de 32 bits dividida en cuatro campos 
de 8 bits. Por ejemplo: 


130.206.82.7 


Para referirse a un usuario perteneciente a un determinado dominio, la sintaxis 
empleada es: 


usuarioe[subdominio].[subdominioJ].[...J].dominio 


Los programas que gestionan los nombres de dominio se denominan servido- 
res de nombres. Cada servidor de nombres posee información completa de una 
determinada zona (subconjunto de un dominio) y de otros servidores de nombres 
responsables de otras zonas. De esta forma, cuando llega una solicitud de infor- 
mación sobre la zona de la que es responsable un determinado servidor, éste sen- 
cillamente proporciona la información. Sin embargo, cuando llega una solicitud 
de información para una zona diferente, el servidor de nombres se pone en contac- 
to con el servidor de esa zona. Los servidores DNS constituyen la base de datos 
distribuida de nombres de Internet. 


La capa de transporte es responsable de la entrega fiable de los datos. En esta 
capa se emplean dos protocolos diferentes: TCP y UDP. TCP toma mensajes de 
usuario de longitud variable y los pasa al nivel de red, solicitando acuse de recibo; 
y UDP es similar, salvo en que no solicita acuse de recibo de los datos. 


La capa de aplicación proporciona una interfaz a la aplicación que ejecuta un 
usuario. Dicho de otra forma, proporciona el conjunto de órdenes que el usuario 
utiliza para comunicarse con otros ordenadores de la red. 


Existen muchos protocolos en TCP/IP. A continuación, se indican algunos 
bastante conocidos: 


e FTP (File Transfer Protocol - Protocolo de transferencia de ficheros). Copia 
ficheros de una máquina a otra. 


e Gopher. Protocolo que permite buscar y recuperar documentos mediante un 
sistema de menús. 


e POP 3 (Post Office Protocol - Protocolo de oficina de correos). Protocolo pa- 
ra gestionar el correo electrónico, en base a su recepción y envío posterior, 
entre el usuario y su servidor de correo. Con este fin son empleados también 
los protocolos IMAP (Internet Message Access Protocol) y HTTP (correo 
web). 


APÉNDICE B: PÁGINAS WEB _ 1085 


e SMTP (Simple Mail Transfer Protocol - Protocolo de transferencia de correo). 
Protocolo para controlar el intercambio de correo electrónico entre dos servi- 
dores de correo en Internet. 


e Telnet (Telecomunications NetWork Protocol - Protocolo de telecomunica- 
ciones de red). Protocolo utilizado para establecer conexiones entre terminales 
remotos. Permite establecer conexiones entre máquinas con diferentes siste- 
mas operativos. 


e  USENet. Nombre con el que se denomina al conjunto de los grupos de discu- 
sión y noticias, establecidos en Internet. La idea de USENEet es servir como 
tablón electrónico de anuncios. 


e HTTP (HyperText Transfer Protocol). Protocolo de transferencia de hipertex- 
to utilizado por WWW (World Wide Web - La telaraña mundial). Se trata de 
un sistema avanzado para la búsqueda de información en Internet basado en 
hipertexto y multimedia. El software utilizado consiste en exploradores 
(browsers), también llamados navegadores, con una interfaz gráfica. 


SERVICIOS EN INTERNET 


Los servicios más comunes son el correo electrónico, la conexión remota, transfe- 
rencia de ficheros, grupos de noticias y la WWW. Programas que facilitan estos 
servicios hay muchos, y su manejo, además de sencillo, es similar. Por eso, inde- 
pendientemente de los que se utilicen en los ejemplos, usted puede emplear los 
suyos de forma análoga. 


En cualquier caso, tenga presente que sólo podrá acceder a Internet si además 
de un ordenador y un módem (un módem es un dispositivo que conecta un orde- 
nador a una línea telefónica), ha contratado dicho servicio con un proveedor de 
Internet, o bien si su ordenador forma parte de una red que le ofrece acceso a In- 
ternet. 


El correo electrónico (correo-e o e-mail) es uno de los servicios más utiliza- 
dos en todo el mundo. Como su nombre indica, tiene como finalidad permitir en- 
viar y recibir mensajes. Un ejemplo de aplicación que proporciona este servicio es 
Microsoft Outlook Express. 


La orden telnet (de Windows, Unix, etc.) proporciona la capacidad de mante- 
ner sesiones como un terminal del ordenador remoto, lo que le permite ejecutar 
órdenes como si estuviera conectado localmente. 
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El protocolo de transferencia de ficheros (ftp) es un método sencillo y efecti- 
vo de transferir ficheros ASCII y binarios entre ordenadores conectados a una red 
TCP/IP. Las órdenes ftp utilizadas con mayor frecuencia son las siguientes: 


Orden ftp Significado 


ascii Establece el modo ASCII para la transferencia de ficheros. 

binary Establece el modo binario para la transferencia de ficheros. 

bye Finaliza la sesión fip y sale. 

cd Cambia de directorio de trabajo en el ordenador remoto. 

close Finaliza la sesión fip. 

ftp Inicia una sesión fip. 

get Obtiene un fichero del ordenador remoto. 

help Proporciona las órdenes ftp disponibles o información relativa a la 
orden especificada. 

led Cambia al directorio local de trabajo. Suele utilizarse para seleccio- 
nar los directorios a los que irán a parar los ficheros transferidos. 

ls Lista el contenido de un directorio remoto. 

mget Obtiene un grupo de ficheros que pueden haberse especificado uti- 
lizando algún comodín. 

mput Envía un grupo de ficheros que pueden haberse especificado utili- 
zando algún comodín. 

open Inicia una conexión ftp con el ordenador remoto especificado. 

put Envía un fichero al ordenador remoto. 


Una interfaz de línea de órdenes proporciona un acceso pleno a las facilidades 
de ftp, pero el riesgo de cometer errores es alto, ya que es fácil equivocarse al es- 
cribir la orden. Afortunadamente existen varias interfaces gráficas de usuario que 
eliminan la posibilidad de error a la que hacíamos mención anteriormente. 


Los grupos de noticias, noticias USENET, netnews o simplemente news, son 
foros de discusión en línea. Los artículos de noticias de USENET se clasifican en 
grupos de noticias por temas (ordenadores, aplicaciones, alpinismo, etc.). 


La World Wide Web, también conocida por WWW o simplemente Web, es uno 
de los logros más interesantes en Internet. La Web es un sistema hipermedia inter- 
activo que permite conectarse a grandes cantidades de información en Internet. Un 
sistema hipermedia está compuesto por páginas que contienen texto cuidadosa- 
mente formateado, imágenes llenas de color, sonido, vídeo y enlaces a otras pági- 
nas distribuidas por todo el mundo. Puede acceder a esas otras páginas 
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simplemente seleccionando uno de los enlaces. La información se recupera auto- 
máticamente sin necesidad de saber dónde está. 


El proyecto Web, que fue iniciado en el Centro Europeo de Investigación Nu- 
clear (European Center for Nuclear Research), ha crecido a una velocidad impre- 
sionante. Esto se debe fundamentalmente a que soporta información de todo tipo: 
texto, sonido y gráficos. 


La forma de establecer una conexión es muy sencilla. Suponiendo que física- 
mente está conectado a Internet, inicie uno de los programas de los muchos que 
hay para navegar por este sistema de información, y automáticamente le mostrará 
una pantalla de información que le conducirá a muchas otras. Por ejemplo, si ini- 
cia la aplicación Microsoft Internet Explorer, se visualizará una ventana similar a 
la siguiente: 


ENANA 


Archivo Edición Ver Favoritos Herramientas Ayuda 


Q ms -Q E] a H JO búsqueda J Favortos E B- 2 - la a 





n [4E] http://www. microsoft .com/spanish/msdn/vs2005/default.mspx 


España 
msdn; 
A 


MSDN Library | Descarga | Mapa | Países | Contacto 
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en Office. 
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Adquirir Visual Studio 2005 con una 








@ Internet 


La ventana del explorador (también llamado navegador) tiene una barra de 
menús donde están todas las órdenes que puede utilizar y una barra de herramien- 
tas correspondientes a las órdenes más utilizadas para navegar por la Web. 


Los botones Atrás y Adelante le permiten moverse a través de las páginas que 
usted ya ha visitado. 


El botón Detener detiene una página que se está cargando actualmente, quizás 
porque usted ha cambiado de opinión una vez que ha visto parte de la página. 
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El botón Actualizar vuelve a cargar la página que se esté visualizando en ese 
momento. A veces, esto es necesario debido a fallos en la red. 


El botón /nicio le permite volver a la página de inicio. Para cambiar su página 
de inicio, vaya a la página que desea que aparezca cuando arranque por primera 
vez el explorador, ejecute la orden Opciones de Internet del menú Herramientas, 
haga clic en la pestaña General y después en Usar actual. 


Cuando hace clic en el botón Búsqueda de la barra de herramientas, aparece el 
panel de búsqueda del navegador a la izquierda de la ventana. Este panel le pro- 
porciona acceso a diversos servicios de búsqueda que ofrecen diferentes clases de 
capacidades de búsqueda. Pruebe los distintos servicios de búsqueda para ver las 
clases de información que proporcionan. 


Si desea buscar información adicional rápidamente, puede escribir go, find o 
? seguido de una palabra o una frase, en la barra de direcciones (espacio en el que 
puede escribir y mostrar la dirección de una página web). Internet Explorer inicia- 
rá inmediatamente una búsqueda mediante el servicio de búsqueda predetermina- 
do. También puede utilizar buscadores como Google, por ejemplo. 


Una vez que esté en una página web, puede buscar un texto específico en di- 
cha página. Para iniciar la búsqueda, haga clic en Buscar en esta página del menú 
Edición. 


PÁGINAS WEB 


Anteriormente ha aprendido cómo acceder a la Web; si ya lo ha hecho, habrá visto 
muchas páginas con magníficos gráficos, listas, formularios y otros elementos 
muy atractivos. Pero, ¿cómo se puede crear una página web de estas característi- 
cas a la que otros usuarios puedan acceder? Hay muchas herramientas que le per- 
mitirán realizarlo. Para ello, antes debe conocer básicamente lo que es HTML 
(HyperText Markup Language - Lenguaje para hipertexto), el lenguaje utilizado 
para construir páginas web. 


Qué es HTML 


HTML es un lenguaje utilizado para desarrollar páginas y documentos web. A di- 
ferencia de los lenguajes convencionales, HTML utiliza una serie de etiquetas es- 
peciales intercaladas en un documento de texto sin formato. Dichas etiquetas 
serán posteriormente interpretadas por los exploradores encargados de visualizar 
la página o el documento web con el fin de establecer el formato. 
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Para editar una página HTML y posteriormente visualizarla, todo lo que nece- 
sita es un editor de texto sin formato y un explorador web. Para ver una página 
HTML no necesita una conexión a la red; cualquier explorador web debe permi- 
tirle hacerlo trabajando en local. No obstante, existen otras herramientas como 
FrontPage que facilitan la generación de páginas HTML. 


Posteriormente, las páginas deben ser colocadas en un servidor web para que 
otros usuarios puedan acceder a ellas. 


Etiquetas básicas HTML 


Las etiquetas indican a los exploradores web cómo tienen que mostrar el texto y 
los gráficos. Normalmente se escriben entre los símbolos < y >, y suele haber una 
etiqueta de comienzo (<texto etiqueta>) y otra de fin (</texto etiqueta>) para en- 
marcar el texto que va a ser formateado por ellas. Muchas etiquetas incluyen dis- 
tintos atributos que detallan la forma de mostrar el texto que aparece entre ellas. 
HTML no es sensible a las minúsculas y mayúsculas. Por ejemplo, la siguiente lí- 
nea de código muestra cómo utilizar atributos y valores con la etiqueta font. La 
etiqueta de apertura incluye el atributo size (tamaño) al que se asigna el valor 10; 
después aparece el texto que se desea mostrar con el tamaño especificado, y a 
continuación la etiqueta de cierre. 


<font size="10">Usuario:</font> 


Todas las etiquetas de una página web se colocan dentro de la etiqueta html, 
la cual define dos secciones: head (cabecera) y body (cuerpo). La etiqueta head 
contiene etiquetas que afectan a la página web completa, por ejemplo title (título), 
y la etiqueta body contiene el resto de las etiquetas que definen el contenido de la 
página web. Según lo expuesto, el esqueleto de una página web puede ser el si- 
guiente: 


<html> 
<head> 
<title>Título del documento</title> 
</head> 
<body> 
Cuerpo del documento: texto, imágenes, sonido y órdenes HTML 
</body> 
</html> 


Guarde ahora estas líneas en un fichero de texto ASCII con el nombre esque- 
leto.html. A continuación, diríjase a la carpeta donde lo ha guardado y haga doble 
clic sobre el nombre del fichero. El resultado será el siguiente: 
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E - Microsoft Internet Explorer 
Archivo Edición Ver Favoritos Herramientas Ayuda a 


€ > [x] a e JO Búsqueda SL Favoritos € (3- a w) + Ly a 3 


» 


Dirección E C:\Documents and Settings|Francisco|Mis documentos|Visual Studio\Projects\Cap16\HTML\esqueleto.htm Y | Ed Ir Vínculos 





Cuerpo del documento: texto, imágenes, sonido y órdenes HTML 








Etiquetas de formato de texto 


Igual que en un documento Word, las páginas HTML pueden tener cabeceras. Las 
cabeceras son insertadas con la etiqueta hn; donde n es un valor de 1 a 6. El ta- 
maño del texto es mayor cuanto mayor es el nivel (el nivel más alto es el 1). Los 
niveles no tienen por qué emplearse consecutivamente. 


Si desea insertar algún tipo de separador, por ejemplo, una raya horizontal, 
puede hacerlo con la etiqueta hr (horizontal rule - raya horizontal). 


Para introducir un párrafo, utilice la etiqueta p o nada. Un párrafo va precedi- 
do automáticamente por una línea en blanco. Los retornos de carro en el texto son 
ignorados; por lo tanto, cuando quiera introducir uno utilice la etiqueta br. 


El siguiente ejemplo clarifica lo expuesto hasta ahora (está localizado en el fi- 
chero Cap15\HTML\texto. html): 


<html> 
<head> 
<title>Título del documento</title> 
</head> 
<body> 
<h1>Ejemplo de un documento HTML</h1> 
<hr> 
<h3>»El cuerpo del documento puede contener:</h3> 
<h4>Texto, imágenes, sonido y órdenes HTML</h4> 
<p> 








HTML es un lenguaje utilizado para desarrollar páginas y 
documentos web. 
<p> 
A diferencia de los lenguajes convencionales, HIML utiliza 
una serie de etiquetas especiales intercaladas en un 
documento de texto sin formato. 
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<br> 
Dichas etiquetas serán 
posteriormente interpretadas por los exploradores 
encargados de visualizar la página o el documento web, con 
el fin de establecer el formato. 

</p><hr> 

</body> 
</html> 


Observe la colocación de las etiquetas. A HTML no le importa que las etique- 
tas estén al final de la línea o en cualquier otra parte. También hay etiquetas que 
no requieren poner la etiqueta final; por ejemplo hr, p o br. 


Los exploradores web ignoran dónde terminan las líneas de texto. El texto se 
ajustará en todo momento al tamaño de la ventana. 


El resultado del código HTML anterior es el siguiente: 


E documento - Microsoft Internet Explorer 


Archivo Edición Yer Favoritos Herramientas Ayuda 


€) trás >) [æ] a EA JO Búsqueda 2 Favoritos € B- $ w] be laa) a 3 


Dirección €] C:\Documents and Settings|FranciscolMis documentos|Yisual StudioiProjects|Cap16|HTMLltexto.htral v Ir Vínculos 


Ejemplo de un documento HTML 


El cuerpo del documento puede contener: 

Texto, imágenes, sonido y órdenes HTML 

HTML es un lenguaje utilizado para desarrollar páginas y documentos Web. 

A diferencia de los lenguajes convencionales, HTML utiliza una serie de etiquetas especiales intercaladas en un 
documento de texto sin formato 


Dichas etiquetas serán posteriormente interpretadas por los exploradores encargados de visualizar la página o el 
documento Web, con el fin de establecer el formato. 





4 miPc 





HTML también proporciona un número de etiquetas para dar formato a las 
palabras y a los caracteres. Por ejemplo, la etiqueta b indica negrita y la i itálica. 
La etiqueta code visualiza un texto monoespaciado. La etiqueta font permite es- 
pecificar el nombre, el tamaño y el color del tipo de letra a utilizar. Por ejemplo: 


<font size=2 face="Arial"> 
Tipo de fuente Arial, tamaño 2; <b>»negrita</b> y <i>cursiva</1> 
</font> 
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La información también se puede organizar en listas empleando la etiqueta li. 
Por ejemplo, si en la página anterior introduce la siguiente modificación, obtendrá 
esta información en forma de lista en lugar de en línea. 


<1li>Texto <l1i>»Imágenes <1i>Sonido <li>Órdenes HTML 


La lista puede numerarse utilizando la etiqueta ol. Por ejemplo, con la si- 
guiente línea, la lista anterior se presentaría numerada. 


<o1>»<1i>Texto <l1i>»Imágenes <1i>Sonido <1i>Órdenes HTML</01> 
El resultado será (ejemplo localizado en el fichero Cap151HATML Vistas. html): 


EN DER) 
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Ejemplo de un documento HTML 


El cuerpo del documento puede contener: 


. Texto 

. Imágenes 

. Sonido 

. Órdenes HTML 








URL 


A los recursos de la Web se accede por medio de una dirección descriptiva cono- 
cida como URL (Uniform Resource Locator - Localizador uniforme de recursos). 
Todo aquello a lo que se puede acceder en la Web tiene un URL. 


Los URL son básicamente una extensión de la ruta que define a un fichero 
(path). Un URL añade, además, un prefijo que identifica el método de recupera- 
ción de la información que ha de emplearse (http, ftp, gopher, telnet, news, etc.), 
así como un nombre de dominio o dirección IP que indica el servidor que almace- 
na la información. Finalmente aparece la ruta de acceso al fichero. Por ejemplo: 


http: //msdn.microsoft.com/library/spa/default.asp 
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Enlaces entre páginas 


Hemos dicho que la World Wide Web es un servicio de información basado en hi- 
pertexto. Se denomina hipertexto a la capacidad de asociar a una palabra o imagen 
de un documento un código oculto, de forma que cuando un usuario haga clic en 
esa palabra o imagen, el sistema lo transporta desde el lugar actual a otro lugar del 
mismo o de otro documento. Estos códigos especiales se denominan enlaces, fo- 
cos, saltos o accesos directos. 


Para definir un enlace, se utiliza la etiqueta a (anchor o ancla). Esta etiqueta 
delimita el texto que se quiere utilizar para enlazar con otra página. Este texto 
aparecerá subrayado para el usuario. 


Para indicar al explorador la página que tiene que recuperar cuando el usuario 
haga clic en un enlace, incluya en la etiqueta de apertura a el atributo href y es- 
criba a continuación el URL de la página que se quiere recuperar. 


También, en documentos largos, se puede utilizar el atributo name para asig- 
nar un nombre a un enlace y después utilizar href en otro lugar dentro de la mis- 
ma página para saltar a ese enlace. Por ejemplo, el siguiente código implementa 
estas dos facilidades (ejemplo localizado en Cap15/HTML/enlaces.html): 


<html> 
<head> 
<ti 


e> 

tulo del documento 

</title> 

</hea 

<body 
<h 


<hr 


MC 


jemplo de un documento HTML</h1> 


J 





AN 
Es y 
[99] 


cuerpo del documento puede contener:</h3> 
<h4 
<o] 
</ 
<p> 








li>Texto <li>Imágenes <li>Sonido <1i>Órdenes HTML</01> 





1 
$ V V Y WY VW Q o» — c+ 


VO ON 


es un lenguaje utilizado para 

desarrollar páginas y documentos web. 

<p> 
A diferencia de los lenguajes convencionales, HTML utiliza 
una serie de etiquetas ASCII especiales intercaladas en un 
documento escrito en ASCII. 

<br> 
Dichas etiquetas serán posteriormente interpretadas por los 
exploradores encargados de visualizar la página o el 
documento web, con el fin de establecer el formato. 

<p> 
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Para editar una página KaIHrSF= MIDE RITENA y 


posteriormente visualizarla, todo lo que necesita es un 
editor de texto ASCII y un explorador web. 
<hr> 
Haga clic <a href="http://www.sitio_web/ini/inicio.html"> 
aquí</a» para ir a la página de inicio 
</body> 
</html> 


El resultado puede verlo en la figura siguiente: 


E documento - Microsoft Internet Explorer 


Archivo Edición Yer Favoritos Herramientas Ayuda a 


Ci >) [æ] a EA JO Búsqueda JE Favoritos e B- EA wj > w u 3 


dirección 1) C:\Documents and Settings|Francisco|Mis documentos|Wisual Studio|Projects|Cap161HTMLlenlaces.html Y Ir Vínculos 


>» 
Dichas etiquetas serán posteriormente interpretadas por los exploradores encargados de visualizar la página o el  % 
documento Web, con el fin de establecer el formato. 


Para editar una página HTML y posteriormente visualizarla, todo lo que necesita es un editor de texto ASCII y 
un explorador Web. 


Haga clic aquí para ir a la biografía de Ceballos 








Gráficos 


Una forma de insertar imágenes en un documento HTML es utilizando la etiqueta 
img y sus atributos sre, que permite especificar el nombre del fichero que contie- 
ne la imagen (habitualmente .gif o .¡peg), y align, que permite indicar cómo el ex- 
plorador debe alinear la imagen con cualquier texto que esté cerca de ella (top, 
middle o bottom). 


Cuando diseñe una página web, piense que puede haber exploradores que no 
soportan gráficos. Para contemplar esta posibilidad, utilizaremos el atributo alt 
que permite especificar un texto en el lugar de la imagen cuando el explorador no 
pueda mostrarla. Por ejemplo: 


<html> 
<hr> 
<center> 
El profesor Ceballos resolviendo dudas a sus alumnos. 
<img sre="ceballos.jpeg" align=bottom 
alt=" [Foto del profesor Ceballos]"> 
</center> 


<hr> 
Haga clic <a href="http://www.sitio_web/ini/inicio.html"> 
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aquí</a» para ir a la página de inicio 
</body> 
</html> 


La etiqueta center centra la imagen y el título de la imagen. 


También desde un documento puede saltar a otro. Por ejemplo: 


Haga clic <a href="ceballos.html"> 
aquí</a> para ir a la biografía de Ceballos. 


El ejemplo anterior indica que cuando el usuario haga clic en la palabra 
“aquí”, se cargará un nuevo documento HTML guardado como ceballos.html. 


Igual que utilizamos una palabra para enlazar con otro lugar, podemos utilizar 
una imagen; esto es, un clic sobre una imagen gráfica le puede conducir a otro lu- 
gar. Por ejemplo: 


<center> 

<a href="enlaces.html"> 

<img sre="ceballos.jpg" align=bottom 
alt="Foto del profesor Ceballos"> 
</a> 

</center> 


El código anterior realizará un salto a la página enlaces.html cuando el usua- 
rio haga clic sobre la imagen ceballos.jpg. Cuando ejecute este código, observe 
que al pasar el ratón por encima de la imagen, el cursor se transforma en una 
mano y aparece una etiqueta que visualiza “Foto del profesor Ceballos”. 


Marcos 


Las páginas HTML que hemos escrito en los apartados anteriores ocupan toda la 
ventana del explorador. Sin embargo, utilizando marcos es posible visualizar múl- 
tiples documentos en una misma página. 


Una forma de insertar un marco flotante en una página es utilizando la etique- 
ta iframe con los atributos src, width y height. El atributo sre especifica el URL 
del documento que se quiere visualizar, y width y height indican la anchura y la 
altura del marco. Por ejemplo: 


<center> 

El autor:<br> 

<iframe sre="ceballos.html" width=650 height=300></1frame> 
</center> 
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El código anterior crea un marco para visualizar el documento ceballos. html. 


Al atributo sre se le puede asignar también una dirección URL de cualquier 
página de cualquier servidor. Esto es, 


<iframe src="http://www.microsoft.com" width=650 height=300></1iframe> 


La figura siguiente muestra un marco dentro de una página. El código puede 
verlo en el fichero marco.html de la carpeta Cap15\HTML del CD. 


F Titulo del documento - Microsoft Internet Explorer 


Archivo Edición Yer Favoritos Herramientas Ayuda 


© A o [x] a e JO Búsqueda JE Favoritos O B- a w] + Ly a 3 


Ó E C:\Documents and Settings\Francisco\Mis documentosiVisual Studio\Projects\Cap16\HTML\marco.html Y Ir Vínculos 
3. Sonido 
4. Ordenes HTML 


El autor: 


El profesor Ceballos resolviendo dudas a sus alumnos 





HTML es un lenguaje utilizado para desarrollar páginas y documentos web. 








Formularios 


Los formularios permiten crear interfaces gráficas de usuario en el seno de una 
página web. Los componentes de estas interfaces, denominados también contro- 
les, serán cajas de texto, cajas para clave de acceso, botones de pulsación, botones 
de opción, casillas de verificación, menús, tablas, listas desplegables, etc. 


Para crear un formulario, se utiliza la etiqueta form. Por ejemplo, el segmento 
de código siguiente muestra cómo es el esqueleto de un formulario HTML: 


<form method=[get|post) action="fichero para procesar los datos"> 
Controles que forman el formulario 
</form> 
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El atributo method es opcional y su valor por omisión es get indicando así al 
navegador que debe agregar los nombres de los campos del formulario y sus datos 
al URL especificado por action (acción a tomar cuando se pulse el botón enviar). 
La cantidad de datos que se puede concatenar al URL está limitada, truncándose 
la información en exceso. Esto no ocurre si el valor para este atributo es post; en 
este caso, se transmite un fichero con los datos del formulario que será recibido en 
el servidor en la entrada estándar del componente de procesamiento. 


Los controles que forman parte del formulario se definen dentro de la etiqueta 
form. En los siguientes apartados se indica cómo crear cada uno de estos contro- 
les. En general, por cada control se envía al servidor su nombre y su contenido o 
valor especificado (si no se especifica un valor, se envía uno por omisión). 


Entrada básica de datos 


Existe una amplia variedad de controles de entrada de datos. Para crearlos, se uti- 
liza la etiqueta input y los atributos type y name: 


<input 
type = [text|password|checkbox|radio|hidden|image|submit|reset) 
name = "Variable que toma el valor" 

> 


El valor del atributo type especifica el tipo de control que se creará, y el del 
atributo name el nombre de la variable que almacenará el dato. 


Caja de texto 


Una caja de texto es un control de entrada de tipo text. Se utiliza para solicitar 
a un usuario que introduzca un dato. Por ejemplo, la siguiente línea de código 
muestra una caja de texto para solicitar un nombre. El tamaño de la caja es 35 y el 
valor será almacenado en la variable nombre: 


Nombre: <input type="text" name="nombre" size="35"> 


El valor del atributo size especifica el tamaño de la caja. Otros atributos que 
se pueden utilizar son value para especificar un valor inicial, readonly (que no 
lleva asociado ningún valor) para indicar que la caja es de sólo lectura y maxlen- 
gth para especificar el número máximo de caracteres que un usuario puede escri- 
bir. 
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Caja de clave de acceso 


Una caja de clave de acceso es un control de entrada de tipo password. Se trata 
de una caja de texto en la que los caracteres escritos son reemplazados por asteris- 
cos. Por ejemplo, la siguiente línea de código muestra una caja de texto para soli- 
citar una clave de acceso. El tamaño de caja es 25, el valor será almacenado en la 
variable clave y el número máximo de caracteres que admite es 20: 


Clave de acceso: <input type="password" name="clave" 
size="25" maxlength="20"> 


Casilla de verificación 


Una casilla de verificación es un control de entrada de tipo checkbox. Se trata 
de un botón que puede presentar dos estados: seleccionado y no seleccionado. Se 
utilizan para mostrar y registrar opciones que un usuario puede elegir; puede se- 
leccionar varias de un grupo de ellas. Por ejemplo, las siguientes líneas de código 
muestran tres casillas de verificación. La primera se mostrará seleccionada: 


<input type="checkbox" name="cv1" value="1" checked> Opción 1 <br> 
<input type="checkbox" name="cv2" value="2"> Opción 2 <br> 
<input type="checkbox" name="cv3" value="3"> Opción 3 <br> 


Se debe especificar el atributo name (como caso especial, se puede especificar 
el mismo nombre para todas). El atributo checked permite iniciar el estado de una 
casilla a seleccionado. Dicho estado, on u off, es almacenado por el atributo 
name. Cuando se envíen los datos del formulario, se enviarán el nombre de la va- 
riable y el valor que indique su estado. También será enviado el valor indicado 
por value o nulo si no se especificó. 


Botón de opción 


Un botón de opción es un control de entrada de tipo radio. Igual que ocurre 
con la casilla de verificación, puede presentar dos estados: seleccionado y no se- 
leccionado. Se utilizan para mostrar y registrar una opción que un usuario puede 
elegir entre varias; cuando selecciona una, la que estaba seleccionada dejará de es- 
tarlo. Por ejemplo, las siguientes líneas de código muestran tres botones de op- 
ción. El segundo se mostrará seleccionado: 


<input type="radio" name="opcion" value="1"> Opción 1 <br> 
<input type="radio" name="opcion" value="2" checked> Opción 2 <br> 
<input type="radio" name="opcion" value="3"> Opción 3 <br> 


Para el comportamiento descrito, todos los botones de opción tendrán el mis- 
mo atributo name y con un valor distinto del atributo value. El valor enviado será 
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el correspondiente al botón seleccionado. El atributo checked permitirá seleccio- 
nar por omisión uno de los botones de un grupo. 


Parámetros ocultos 


Un parámetro oculto es un control de entrada de tipo hidden. En este caso no 
se muestra ningún campo de entrada de datos al usuario, pero el par variable valor 
especificado es enviado junto con el formulario. 


<input type="hidden" name="variable" value="valor"> 
Se suelen utilizar para mantener datos durante una sesión. 
Enviar datos 


Un botón enviar es un control de entrada de tipo submit. Se utiliza para enviar 
los datos del formulario, pasando el control al programa indicado por el atributo 
action del formulario. Todo formulario debe tener un botón submit, a menos que 
incluya una caja de texto. 


<input type="submit" value="Enviar datos"> 


El atributo value especifica una etiqueta no editable que se mostrará como títu- 
lo del botón. Lo normal es que este control no envíe datos, pero si se incluye el 
atributo name con un nombre de variable, será enviada la variable con el valor de 
value. Esto puede ser útil para distinguir cuál fue el botón pulsado cuando se in- 
cluyan varios. 


<input type="submit" name="enviar" value="Enviar"> 
<input type="submit" name="buscar" value="Buscar"> 


Borrar los datos de un formulario 


Un botón borrar es un control de entrada de tipo reset. Se utiliza para restable- 
cer los valores iniciales de los controles del formulario. 


<input type="reset" value="Borrar datos”> 
Imágenes 


Una imagen es un control de entrada de tipo image. Su finalidad es análoga al 
botón submit, pero en este caso se presenta una imagen en lugar de un botón. Los 
datos del formulario se enviarán al hacer clic sobre la imagen .jpg o .glf. 


<input type="image" src="fichero.jpg"> 
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Orden de tabulación 


Para trasladarse de un control a otro del formulario, el usuario puede utilizar la te- 
cla tab. En este caso, el orden en el que los controles serán recorridos queda de- 
terminado por su orden de aparición en el formulario, o bien por el atributo 
tabindex. Por ejemplo: 


<input type="text" name="nombre" size="30" tabindex="1"> 


El valor de tabindex es un número (1, 2, 3...) que corresponde al orden en el 
que se seleccionará un control cuando el usuario pulse la tecla tab. El control que 
se seleccionará en primer lugar es el 1. 


Caja de texto multilínea 


En ocasiones es necesario permitir al usuario escribir varias líneas de texto libre; 
por ejemplo, un mensaje. Para esto se utiliza un control denominado área de texto 
(textarea) que incluye una barra de desplazamiento vertical: 


Mensaje: <br><textarea name="mensaje" 
rows="5" cols="20" wrap> 
</textarea> 


El valor del atributo rows especifica el número de filas que visualizará el área 
de texto a la vez y cols el número de caracteres por fila. El atributo wrap, que no 
lleva asociado ningún valor, indica que se saltará automáticamente a la línea si- 
guiente cuando se complete la línea en la que se escribe. 


Listas desplegables 


Una lista desplegable permite seleccionar una opción entre varias. Es la mejor al- 
ternativa para añadir menús a una interfaz gráfica. La etiqueta que permite crear 
un control de este tipo es select. Las opciones de la lista se especifican utilizando 
la etiqueta option. Por ejemplo, el siguiente código mostrará una lista desplegable 
con tres opciones, de las cuales aparecerá seleccionada inicialmente la segunda: 


<select name="opcion"> 
<option value="1"> Opción 1 
<option selected value="2"> Opción 2 
<option value="3"> Opción 3 
</select> 
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El atributo value de option indica el valor asociado con la opción especifica- 
da; si se omite este atributo, el valor que se toma es el texto especificado para la 
opción. La etiqueta option que contenga el atributo selected será considerada la 
opción por omisión; en caso de que no se especifique ninguna se considerará la 
primera de las opciones. Se puede también especificar el atributo size para indicar 
el número de opciones que la lista visualizará a la vez. 


Para permitir realizar selecciones múltiples utilizando las teclas Ctrl o Alt, hay 
que añadir el atributo multiple; en este caso se mostrará una lista desplegada. Por 
ejemplo: 


<select name="opcion" multiple> 
<option value="1"> Opción 1 
<option selected value="2"> Opción 2 
<option value="3"> Opción 3 
</select> 


Utilizando la etiqueta optgroup, se pueden agrupar las opciones (como si de 
un submenú se tratara); cada grupo será identificado con una etiqueta especificada 
por el atributo label. Por ejemplo: 


<select name="opcion"> 
<optgroup label="grupo 1"> 
<option value="1"> Opción 1 
<option value="2"> Opción 2 
<option value="3"> Opción 3 
</optgroup> 
<optgroup label="grupo 2"> 
<option value="4"> Opción 4 
<option value="5"> Opción 5 
</optgroup> 
</select> 




















Aplicando la teoría expuesta hasta ahora, vamos a diseñar un formulario, co- 
mo el que muestra la figura siguiente, que permita a un alumno concertar una tu- 
toría con su profesor. 
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$ Concertar una tutoria - Microsoft Internet Explorer 


Archivo Edición Ver Favoritos Herramientas Ayuda 


Q ee O [æ] a € JO Búsqueda JE Favoritos © B- N mA > la a 3 


Dirección lE C:\Documents and Settings|Francisco|Mis documentos|Visual Studio|Projects|Cap16/HTMLtutorias,html | [54 r Vínculos 


CONCERTAR UNA TUTORÍA 





| 


Con el profesor: 











Día: 


[lunes B 
Hora 100 120 160 180 


Asunto: 








Enviar datos Restablecer 








El código HTML que da lugar a este formulario puede ser el siguiente (la ex- 
presión «nbsp indica un espacio en blanco). El código puede obtenerlo del fiche- 
ro Cap 5\HTMLi\tutorias.html del CD. 


<html> 
<head> 
<title>Concertar una tutoría</title> 
</head> 
<body> 
<hl align="center" >CONCERTAR UNA TUTORÍA</h1> 
<form action="http://localhost:8080/miap/tutorias" 
method=post> 
Alumno:<br><input type="text" name="alumno" size="60"> 
<br><br>Con el profesor: 
<br><input type="text" name="profesor" size="60"> 
<br><br>Día:<br> 
<select name="día"> 
<option>lunes <option»miércoles <option>jueves 
</select> 
<br><br>Hora: 
énbsp;8nbsp;anbsp;10<input type="radio" name="hora" value="10" 
checked> 
&nbsp;&nbsp;&nbsp;12<input type="radio" name="hora" value="12"> 
&nbsp;&nbsp;&nbsp;16<input type="radio" name="hora" value="16"> 
&nbsp;&nbsp;&nbsp;18<input type="radio" name="hora" value="18"> 
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<br><br>Asunto:<br><textarea name="asunto" 
rows="5" cols="40" wrap></textarea> 
<br><br><input type="submit" value="Enviar datos"> 
&nbsp;&nbsp;<input type="reset"> 
</form> 
</body> 
</html> 


Tablas 


Para crear una tabla, se utilizan las etiquetas table, tr, th y td. La etiqueta table 
define el cuerpo de la tabla; tr define una fila de la tabla; th define una celda de 
cabecera y td define una celda de datos. Por ejemplo: 


<table border="1"> 
<tr> 
<th>»Nombre</th> 
<th»Nota</th> 
</tr> 
<tr> 
<td width=200>Javier Ceballos Fernández</td> 
<td width=30 align=right>10.00</td> 
</tr> 
<tr> 
<td width=200>Elena Ortiz Fuentes</td> 
<td width=30 align=right>7.50</td> 
</tr> 
</table> 


c 








El atributo border de table permite añadir un borde a la tabla de ancho igual 
al valor especificado en píxeles. Los atributos width y align de td (o de th) per- 
miten definir, respectivamente, el ancho de la celda y el tipo de ajuste del dato en 
la celda. 


Otras operaciones que se pueden hacer a la hora de diseñar una tabla son: 


e Extender una celda en múltiples columnas: 
<th colspan=2> cabecera 1</th> 

e Extender una celda en múltiples filas: 
<th rowspan=2> cabecera 1</th> 


e Modificar el ancho y el alto de la tabla en valor absoluto o respecto al tamaño 
de la ventana del navegador: 


<table width=60% height=80%> 
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e Modificar el tamaño de una celda: 
<td width=200 height=50> 


e  Alinear el contenido de una celda: 


<td valign=top align=left> 


e Modificar el color de fondo de una celda: 





<td bgcolor="green"> 


e Modificar el espacio y el margen de las celdas: 


<table border cellspacing="8" cellpadding="8"> 


e Controlar los saltos de línea en una celda: 


<td nowrap> 


HOJAS DE ESTILO 


Es evidente que el lenguaje HTML está limitado a la hora de organizar la presen- 
tación de los elementos de una página web. Pues bien, para cubrir esta deficiencia 
surgen las hojas de estilo (Cascade Style Sheets - CSS). Éstas no sólo permiten 
organizar la presentación de una página, sino que además, intentan separar el con- 
tenido de la forma de presentarlo. 


Por ejemplo, para introducir un nuevo párrafo en una página web, utilizamos la 
etiqueta <p>. Pues bien, con las hojas de estilo también podremos indicar que su 
texto sea azul, que tenga un margen izquierdo de 20 píxeles y que tenga un borde 
de ancho 2. Esto se codificaría de la forma siguiente: 


<style type="text/css"> 
p [color: blue; margin-left: 20; border: solid; border-width: 2) 
</style> 


En este ejemplo se puede observar que la declaración de los atributos que defi- 
nen un determinado elemento de la página queda limitada por la etiqueta style. 
Esta etiqueta sólo puede utilizarse en la cabecera de la página, o bien dentro de la 
etiqueta de cabecera del elemento, y su parámetro type indica la sintaxis utilizada 
para definir esos atributos. En el caso de las hojas de estilo en cascada, el tipo de- 
berá ser “text/css”. También observamos que los atributos se especifican a conti- 
nuación del elemento HTML que se quiere personalizar, encerrados entre llaves. 
En el ejemplo, son cuatro: el color (en el formato habitual), el margen izquierdo 
en píxeles y el tipo y el ancho del borde. Tenga presente que CSS es sensible a las 
mayúsculas y minúsculas. Puede ver un resumen de los atributos CSS en la carpe- 
ta docs del CD que acompaña al libro. 
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El siguiente ejemplo muestra una página HTML con estilo: 


<html> 

<head> 
<title>Título del documento</title> 
<style type="text/css"> 

p {color: blue; margin-left: 20; border: solid; border-width: 2} 

</style> 

</head> 

<body> 
<h1>Ejemplo de un documento HTML</h1> 
<hr> 
<h3>»El cuerpo del documento puede contener:</h3> 
<h4>Texto, imágenes, sonido y órdenes HTML</h4> 
<p> 





HTML es un lenguaje utilizado para desarrollar páginas y 
documentos web. 
<p> 





A diferencia de los lenguajes convencionales, HTML utiliza 
una serie de etiquetas especiales intercaladas en un 
documento de texto sin formato. 

<br> 
Dichas etiquetas serán 
posteriormente interpretadas por los exploradores 
encargados de visualizar la página o el documento web, con 
el fin de establecer el formato. 

<hr> 

</body> 
</html> 








Cuando se muestre la página anterior, los dos párrafos, <p>, serán visualiza- 
dos con los atributos definidos. Ahora bien, en este ejemplo, el contenido no está 
separado de la forma de presentarlo. Para separarlo, podemos colocar la hoja de 
estilo en un fichero (sólo los estilos, sin style), por ejemplo, en estilo.css: 


/* estilo.css */ 
p (color: blue; margin-left: 20; border: solid; border-width: 2) 


Una vez definida una hoja de estilos, podemos incorporarla a una página 
HTML utilizando la etiqueta link que tiene la siguiente sintaxis: 


<link rel="stylesheet" href="estilo.css" type="text/css"> 


Según lo explicado, el ejemplo anterior quedaría como se indica a continua- 
ción. Observe que la etiqueta link está incluida dentro de la cabecera: 


<html> 
<head> 
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<title>Título del documento</title> 
<link rel="stylesheet" href="estilo.css" type="text/css"> 
</head> 
<body> 
</body> 
</html> 


Clases 


Cuando se muestre la página anterior, todos sus párrafos, <p>, serán visualizados 
con los atributos definidos. Pero supongamos que sólo queremos personalizar al- 
gunos de ellos. ¿Cómo lo hacemos? Pues, definiendo distintas clases, en nuestro 
caso, distintas clases de párrafos, para lo cual utilizaremos el atributo class. Por 
ejemplo, la siguiente hoja de estilos permite personalizar un párrafo de dos for- 
mas, las cuales difieren en el color: azul con borde y ajustado a la izquierda, o 
bien verde sin borde y centrado: 


/* estilo.css */ 
p.azul {color: blue; margin-left: 20; border: solid; border-width: 2) 
p.verde (color: green; margin-left: 20; text-align: center) 


Este código define dos clases de párrafos: el párrafo azul (p.azul) y el verde 
(p.verde). 


Cuando apliquemos estos estilos a una página, los párrafos definidos con la 
cabecera <p class="azul"> serán azules y los definidos como <p class="verde"> 
serán verdes. Por ejemplo: 


<html> 
<head> 
<title>Título del documento</title> 
<link rel="stylesheet" href="estilo.css" type="text/css"> 
</head> 
<body> 
<h1>Ejemplo de un documento HTML</h1> 
<hr> 
<h3>»El cuerpo del documento puede contener:</h3> 
<h4>Texto, imágenes, sonido y órdenes HTML</h4> 
<p class="verde"”> 
HTML es un lenguaje utilizado para desarrollar páginas y 
documentos web. 
«(pelas "anio 
A diferencia de los lenguajes convencionales, HTML utiliza 
una serie de etiquetas especiales intercaladas en un 
documento de texto sin formato. 
<br> 
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Dichas etiquetas serán 
posteriormente interpretadas por los exploradores 
encargados de visualizar la página o el documento web, con 
el fin de establecer el formato. 
<hr> 
</body> 
</html> 


Otro caso puede ser que queramos que la mayoría de todos los párrafos sean 
azules y unos pocos verdes, pero con el resto de las características iguales. En este 
caso, también podríamos definir dos clases distintas, pero hay una forma mejor: 
usar el parámetro id. Por ejemplo: 


/* estilo css */ 
p fcolor: blue; margin-left: 20; border: solid; border-width: 2) 
#verde (color: green) 


Cuando apliquemos estos estilos a una página, los párrafos definidos con la 
cabecera <p> serán azules y los definidos como <p id="verde"> serán verdes. 


Los exploradores agregan también varias clases, conocidas como pseudocla- 
ses, que definen varios usos para un mismo elemento. Por ejemplo, podemos apli- 
car estilo a los enlaces para que muestren colores diferentes en función de que aún 
no hayan sido visitados o sí lo hayan sido. Para ello CSS define las pseudoclases: 


e Enlaces normales: a:link (atributos) 
e Enlaces visitados: a:visited {atributos} 
e Enlaces activos: a:active {atributos} 


Por ejemplo, el siguiente código utiliza las pseudoclases link y visited con el 
elemento <a> para definir el color azul para el enlace normal y el color magenta 
para el enlace visitado. Observe la sintaxis; al contrario que con las clases reales, 
ahora se utilizan dos puntos (:). 


a:link {color: blue} 
a:visited {color: magenta} 


Etiquetas <span> y <div> 


Puede que, a veces, no queramos modificar el comportamiento de un elemento, 
sino aplicar un estilo completo a una determinada sección de una página. Esto po- 
dremos hacerlo utilizando las etiquetas <span> y <div>. 
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Para definir estilos en secciones reducidas de una página se utiliza la etiqueta 
span. Admite los atributos style, id y class. Lo vemos con un ejemplo. El siguien- 
te párrafo visualizará determinadas palabras en color azul y en cursiva: 


<p> 
A diferencia de los lenguajes convencionales, 
<span style="color:blue; font-style:italic"> 
HTML utiliza una serie de etiquetas especiales intercaladas 
en un documento de texto sin formato. 
</span> 
</p> 


La etiqueta div es similar a span, con la diferencia de que div define un ele- 
mento a nivel de bloque; esto es, una sección de una página que, a su vez, puede 
contener cabeceras, párrafos, tablas, e incluso otras divisiones, lo que hace a esta 
etiqueta ideal para definir distintas secciones en un documento (capítulo, resumen, 
notas, etc.). Por ejemplo: 


<div class=notas>» 

<h1>Divisiones</h1> 

<p>El elemento div permite utilizar los atributos align, class, 
style, id y otros muchos.</p> 

<p>Definir un bloque, es útil para construir diferentes secciones 
en un documento.</p> 

<p>»Es necesario especificar la etiqueta de cierre</p> 

</div> 


La etiqueta div es ideal también para definir capas, entendiendo por capa una 
sección de un documento para la que se ha definido un comportamiento indepen- 
diente. Algunos atributos típicos utilizables con capas son: position, posición ab- 
soluta en la página, left y top, distancia desde los bordes izquierdo y superior de 
la página, width y height, anchura y altura de la capa, z-index, para indicar qué 
capas se ven encima de qué otras, clip, para recortar una capa y hacer que no sean 
visibles partes de ella, o visibility, para indicar si la capa se puede ver en la pági- 
na o permanece oculta al usuario. 


A continuación mostramos un ejemplo sencillo: poner un título con el efecto 
de sombra. Este ejemplo se ha construido en base a dos bloques con el mismo 
contenido: uno para visualizar el título en color azul y otro para visualizar la som- 
bra en color negro (se trata del mismo título, pero desplazado un píxel respecto 
del anterior). 


TÍTULO DE LA PÁGINA 
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El fichero de estilos que vamos a utilizar incluye dos clases, título y sombra. 
Obsérvese que delante del nombre de la clase ponemos solamente un punto, ya 
que en este caso no se trata de una clase definida para un determinado elemento: 


/* estilos.css */ 
.titulo (color: blue; position:absolute; margin-left: 20; 
margin-top: 20; font-size: 32; font-weight: bolder} 


.sombra ([color: black; position:absolute; margin-left: 21; 
margin-top: 21; font-size: 32; font-weight: bolder} 


Y una página ejemplo que utilice este fichero de estilos puede ser la siguiente: 


<html> 
<head> 
<title>»Capas</title> 
<link rel="stylesheet" href="estilos.css" type="text/css"> 
</head> 
<body> 
<div class="sombra"> 
ULO DE LA PÁGINA 
</div> 
<div class="titulo"> 
ULO DE LA PÁGINA 
</div> 
</body> 
</html> 





Es 














Es 


XML 


XML (Extensible Markup Language - lenguaje extensible para análisis de docu- 
mentos) está convirtiéndose rápidamente en el estándar para el intercambio de da- 
tos en la Web. Como en el caso de HTML, los datos se identifican utilizando 
etiquetas, y a diferencia de HTML las etiquetas indican lo que los datos significan 
en lugar de cómo visualizar los datos. Por ejemplo, la fecha de nacimiento de una 
persona se puede colocar en un párrafo HTML así: 


<p>01/01/2004</p> 


Sin embargo, la etiqueta de párrafo no describe que el dato es la fecha de na- 
cimiento. Simplemente indica al navegador que el texto que aparece entre las eti- 
quetas se debe mostrar en un párrafo. En cambio, el dato sí queda descrito en una 
línea como la siguiente: 


<FechaNacimiento>01/01/2004</FechaNacimiento> 
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El lenguaje XML es un lenguaje que se utiliza para crear otros lenguajes que 
definen los componentes de un documento. Por ejemplo, podríamos utilizar XML 
para describir una persona: fecha de nacimiento, sexo, color, altura, peso, etc. 


La creación de un documento XML tiene dos partes: crear un esquema XML 
y crear el documento utilizando los elementos definidos en el esquema. 


El esquema se puede considerar como un diccionario que define las etiquetas 
que se utilizan para describir los elementos de un documento. Estas etiquetas son 
similares a las etiquetas HTML, pero con la diferencia de que quien crea el es- 
quema crea los nombres y los atributos de las etiquetas. Por ejemplo: 


<foto origen="ceballos.jpg">Profesor Ceballos</foto> 


La realidad es que un navegador no puede leer y mostrar un documento XML. 
Pero sí puede convertir un documento XML en un documento HTML mediante 
una hoja de estilos XSTL (Extensible Stylesheet Language Transformation). Una 
hoja de estilos se compone de una o más definiciones de plantillas que procesa un 
procesador XSLT cuando la etiqueta de la plantilla corresponde a un componente 
del documento XML. 


XHTML 


XHTML (Extensible HyperText Markup Language - lenguaje mejorado para la 
escritura de páginas web) es la siguiente generación de HTML que incorpora mu- 
chas de las características de XML. Utiliza prácticamente todos los elementos de 
HTML, pero impone nuevas reglas; por ejemplo, es sensible a mayúsculas y mi- 
núsculas, toda etiqueta de apertura tiene que tener una etiqueta de cierre, etc. 


PÁGINAS WEB DINÁMICAS 


El lenguaje HTML que hemos visto en los apartados anteriores es suficiente para 
visualizar documentos, imágenes, sonidos y otros elementos multimedia; pero el 
resultado es siempre una página estática. 


Entonces, ¿qué podemos hacer para construir una página dinámica?, enten- 
diendo por página dinámica una página que actualiza su contenido mientras se vi- 
sualiza. 


Haciendo un poco de historia, una de las primeras formas que se encontraron 
para dar dinamismo a las páginas HTML fue la CGI (Common Gateway Interfa- 
ce). Esta interfaz permite escribir pequeños programas que se ejecutan en el servi- 
dor para aportar un contenido dinámico. El resultado es un código HTML, que se 
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incluye en la página web justo antes de ser enviada al cliente. Pese a que la CGI 
es fácil de utilizar, en general, no es un buen sistema porque cada vez que un 
cliente solicita una página con algún programa basado en esa interfaz, el programa 
tiene que ser cargado en memoria para ser ejecutado, lo que ocasiona un tiempo de 
espera elevado. Además, si el número de usuarios es elevado, los requerimientos de 
memoria también serán elevados, ya que todos los procesos se deben poder cargar 
en memoria y ejecutar. 


Una alternativa a la CGI fue ISAPI (Internet Server Application Program- 
ming Interface). Esta API proporciona la funcionalidad necesaria para construir 
una aplicación servidora de Internet. A diferencia de CGI que trabaja sobre ejecu- 
tables, ISAPI trabaja sobre DLL. Esta diferencia hace que ISAPI sea un sistema 
más rápido, ya que por tratarse de una biblioteca dinámica sólo será cargada una 
vez y podrá ser compartida por múltiples procesos, lo que supone pocos requeri- 
mientos de memoria. 


Posteriormente, las técnicas anteriores fueron sustituidas por la incorporación 
de secuencias de órdenes (scripts) ejecutadas directamente en el interior de la pá- 
gina HTML. Esto es, en lugar de consultar al servidor acerca de un ejecutable, el 
explorador puede ahora procesar las secuencias de órdenes a medida que carga la 
página HTML. El tratamiento de estas secuencias de órdenes puede hacerse tanto 
en el servidor web como en el cliente. Los lenguajes más comunes para la escritu- 
ra de secuencias de órdenes son JavaScript y VBScript. 


Apoyándose en la técnica anterior y en un intento de potenciar la inclusión de 
contenido dinámico en páginas web, Microsoft lanza una nueva tecnología, las 
páginas ASP (Active Server Page - Página activa del servidor o activada en el ser- 
vidor). Una página ASP, dicho de una forma sencilla, es un fichero .asp que pue- 
de contener: texto, código HTML, secuencias de órdenes y componentes ActiveX. 
Con tal combinación se pueden conseguir de una forma muy sencilla páginas di- 
námicas y aplicaciones para la Web muy potentes. Un inconveniente de esta tec- 
nología es que su propietaria es Microsoft y solamente está disponible para el 
servidor IIS (Internet Information Server) que se ejecuta sobre plataformas Win- 
dows. También es cierto que hay herramientas que permiten utilizar ASP sobre un 
servidor Apache en plataformas Unix, pero, hoy por hoy, los componentes Acti- 
veX no están disponibles para plataformas que no sean Microsoft Windows. 


Cuando un cliente solicita una ASP, el servidor la intenta localizar dentro del 
directorio solicitado, igual que sucede con las páginas HTML. Si la encuentra, 
ejecutará las rutinas VBScript o JScript que contenga. Cuando el servidor ejecuta 
estas rutinas, genera un resultado consistente en código HTML estándar que susti- 
tuirá a las rutinas VBScript o JScript correspondientes de la página ASP. Una vez 
procesada la página, el servidor envía al cliente el contenido de la misma en 
HTML estándar, siendo así accesible desde cualquier navegador. 
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También, cuando Sun Microsystems presentó Java, uno de los aspectos que 
más llamó la atención fueron los applets: pequeños programas interactivos que 
son ejecutados por un navegador. Esto supuso una alternativa más para crear pá- 
ginas web dinámicas, ya que esta tecnología permite vincular código estándar Ja- 
va con las páginas HTML que luego utilizaremos como interfaz de usuario, 
dotándolas de contenido dinámico e interactivo. Posteriormente, Sun Microsys- 
tems introdujo los servlets. Mientras que los applets incorporaron funcionalidad 
interactiva a los navegadores, los servlets la incorporaron a los servidores. Los 
servlets es la alternativa de Sun Microsystems para sustituir a la programación 
CGL 


Si comparamos la tecnología ASP o los servlets con la CGI o con la ISAPI, 
llegaremos a la conclusión de que es bastante más sencilla y más potente. 


Actualmente, la tecnología ASP ha sido sustituida por ASP.NET, que es parte 
integrante de Microsoft .NET Framework. ASP.NET es algo más que una nueva 
versión de ASP; es una plataforma de programación web unificada que propor- 
ciona todo lo necesario para que podamos crear aplicaciones web. Al crear una 
aplicación web, podemos elegir entre formularios web y servicios web XML, o 
bien combinarlas. Todo esto lo estudiaremos en los próximos capítulos. 


Los formularios web permiten crear páginas web basadas en formularios. Por 
lo tanto, este tipo de aplicaciones son una alternativa más para crear páginas web 
dinámicas. 


Los servicios web XML proporcionan acceso al servidor de manera remota, 
permitiendo el intercambio de datos en escenarios cliente-servidor utilizando es- 
tándares como HTTP y XML. 


Las aplicaciones web se ejecutan en un servidor web configurado con los ser- 
vicios de Internet Information Server (IIS). Sin embargo, para probar una aplica- 
ción web, no es necesario trabajar directamente con IIS, sino que se puede hacer a 
través del servidor web integrado en Visual Studio. No obstante, si para probar 
sus aplicaciones prefiere utilizar IIS, asegúrese de que lo tiene instalado. Para ello, 
abra el panel de control, seleccione “agregar o quitar programas”, haga clic en 
“agregar o quitar componentes Windows” y si no tiene instalado el componente 
Servicios de Internet Information Server, instálelo. IIS debe instalarse antes de 
Microsoft .NET Framework SDK. 
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INTERNACIONALIZACIÓN 


Si pensamos distribuir nuestra aplicación a un público internacional, deberemos 
tener en cuenta una serie de puntos durante las fases de diseño y desarrollo. Los 
servicios integrados en .NET Framework facilitan el desarrollo de aplicaciones 
que se adaptan a distintas configuraciones de idioma. 


Preparar una aplicación para su uso mundial tiene dos partes: diseñar la apli- 
cación para que pueda adaptarse a distintas referencias culturales (globalización) 
y traducir los recursos para una referencia cultural específica (localización). 


GLOBALIZACIÓN 


La globalización es el proceso de diseño y desarrollo de una aplicación que per- 
mite el uso de interfaces de usuario en distintos idiomas. 


El espacio de nombres System.Globalization contiene clases que definen in- 
formación relativa a la referencia cultural, incluido el idioma, el país o región, los 
calendarios utilizados, los modelos de formato de fecha, moneda y números, y el 
criterio de ordenación de las cadenas. Concretamente, la clase CultureInfo repre- 
senta una referencia cultural específica. 


LOCALIZACIÓN 


Los recursos de la aplicación que requieren una localización tienen que ser inde- 
pendientes del resto del código de la aplicación. Para ello, el código ejecutable se 
ubicará en el ensamblado principal de la aplicación, mientras que en los ficheros 
de recursos sólo se ubicarán los recursos: cadenas, mensajes de error, cuadros de 
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diálogo, menús o recursos de objetos incrustados, entre otros. Finalmente, se tra- 
duce la interfaz de usuario a los idiomas de destino. 


.NET Framework SDK proporciona la herramienta winres.exe (editor de re- 
cursos de formularios Windows), que permite localizar rápidamente formularios 
Windows para las referencias culturales de destino. 


CLASE Culturelnfo 


La clase CultureInfo especifica un nombre único para cada referencia cultural 
como una combinación de un código de referencia cultural (dos letras en minús- 
culas asociado con un idioma), y un código de referencia cultural secundaria (dos 
letras en mayúsculas asociado con un país o región) separados por un guión (-). 
Por ejemplo, “en-US” para el inglés de EEUU y “es-ES” para el español de Espa- 
ña. Por ejemplo, el siguiente código muestra todas las referencias culturales por 
medio del método GetCultures de CultureInfo: 


using System; 
using System.Globalization; 


class CInfoCultura 
( 
static void Mainí(string[] args) 
( 
foreach (CultureInfo info in Culturelnfo.GetCultures( 
CultureTypes.AllCultures)) 
// Mostrar todas las referencias culturales 
Console.WriteLine("(0,-12) (1)", info, info.DisplayName); 


Siguiendo con el ejemplo anterior, vamos a añadir a la clase CInfoCultura un 
método Cultura que muestre información de una cultura específica. 


public static void Culturaílstring sInfo) 
( 
CultureInfo info = new Culturelnfo(sInfo); 
Console.WritelLine("(0,-12) (1)", info, info.DisplayName); 
Console.WriteLine("Formato de fecha: (0)", 
DateTime.Now.ToStringí(info.DatelTimeFormat.ShortDatePattern)); 
Console.WriteLine("Separador de decimales: (0)", 
info.NumberFormat.CurrencyDecimalSeparator); 
Console.WriteLine(); 
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Para invocar al método anterior, añada al método Main sentencias análogas a 
las siguientes: 


Cultura("en-US"); 
Cultura("es-ES"); 


Propiedad CurrentUlCulture 


La propiedad CurrentUlCulture de Culturelnfo devuelve la referencia cultural 
de la interfaz de usuario actual. Por ejemplo: 


public static void CulturaActual() 
( 
CultureInfo info = null; 
info = Culturelnfo.CurrentUlCulture; 
Console.Write("Cultura actual: "); 
Console.WriteLine("(0, -12) (1)", info, info.DisplayName); 


También puede utilizar la propiedad CurrentUlCulture de Thread.Cu- 
rrentThread. Por ejemplo: 


info = System.Threading.Thread.CurrentThread.CurrentUlCulture; 


La clase ResourceManager utiliza esta propiedad para buscar recursos espe- 
cíficos de la referencia cultural durante la ejecución. 


Para configurar la propiedad CurrentUlCulture, se puede utilizar una refe- 
rencia cultural neutra (por ejemplo, “en”) o específica (por ejemplo, “en-US”), o 
la propiedad InvariantCulture. Por ejemplo, la siguiente línea establece la refe- 
rencia cultural neutra “en” (inglés). Las referencias culturales neutras se asocian a 
idiomas pero no a regiones. 


Thread.CurrentThread.CurrentUlCulture = new Culturelnfo("en"); 


Y esta otra línea establece la referencia cultural específica “en-US” (inglés de 
Estados Unidos): 


Thread.CurrentIhread.CurrentUlCulture = new Culturelnfo("en-US"); 


Propiedad CurrentCulture 


La propiedad CurrentCulture de CultureInfo no es una configuración de idio- 
ma, sino que determina los formatos predeterminados para la fecha, hora, moneda 
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y números, el criterio de ordenación de texto, las comparaciones de cadenas y la 
distinción entre mayúsculas y minúsculas. Sólo se puede establecer para una refe- 
rencia cultural específica o para InvariantCulture. Para establecer el valor de es- 
ta propiedad puede utilizar la propiedad Thread.CurrentThread. Por ejemplo: 


Thread.CurrentThread.CurrentCulture = new Culturelnfo("en-US"); 


Propiedad InvariantCulture 


La propiedad InvariantCulture de CultureInfo no es una referencia cultural 
neutra ni específica. Es un tercer tipo que no tiene en cuenta la referencia cultural. 
Se encuentra asociada al idioma inglés pero a ningún país o región. Se puede uti- 
lizar InvariantCulture en cualquier método que requiera una referencia cultural. 
No obstante, deberá utilizarla únicamente para los procesos que requieran resulta- 
dos independientes de la referencia cultural. 


APLICACIÓN EJEMPLO 


Vamos a realizar un ejemplo sencillo que nos enseñe a internacionalizar una apli- 
cación. Como podremos comprobar, será el propio Visual Studio el que se encar- 
gue de adaptar cada elemento de la interfaz a cada idioma. 


Nuestra aplicación utilizará como idioma predeterminado el español y, ade- 
más, el idioma inglés. La interfaz gráfica de la misma constará de dos formula- 
rios: el formulario principal y el formulario “Acerca de”. El formulario principal 
incluirá una barra de menús, con los menús “Archivo”, “Opciones” y “Ayuda”, 
una caja de texto, un botón y una barra de estado. El menú “Archivo” incluirá una 
orden “Salir”, “Opciones” contendrá un submenú “Idioma” con las órdenes “Es- 
pañol” e “Inglés”, y el menú “Ayuda” la orden “Acerca de...”. 


Generar ficheros de recursos automáticamente 


Para empezar crearemos una nueva aplicación Windows. Se mostrará el formula- 
rio Forml. 


A continuación, asignamos a la propiedad Localizable de Form1 el valor 
True. De esta forma, todas las propiedades persistirán en el fichero de recursos, 
con la ventaja de que este fichero se puede traducir sin modificar el código. 


La propiedad Language asume un valor que hace referencia al lenguaje pre- 
determinado (Default), en nuestro caso al español. Por lo tanto, en principio, no 
modificaremos el valor de esta propiedad. 
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Añadimos al formulario todos los recursos enumerados anteriormente. Estos 
recursos se almacenarán en el fichero Forml.resx. 


H Formi 
| Archivo | Opciones Ayuda 











Para realizar el diseño en otro idioma, asignamos a la propiedad Language 
dicho idioma; en nuestro caso, le asignamos el valor English. El diseñador mos- 
trará en la pestaña “Form1.cs[Diseñar — Inglés)”. A continuación, modificaremos 
todos los elementos que deben mostrar su contenido en inglés (menús, acelerado- 
res, botones, etc.). Obsérvese que podemos cambiar el valor, no sólo de la propie- 
dad Text, sino de otras muchas propiedades (ShortcutKeys, Size, Location, etc.). 


E Form! AE 


Archive 











Cuando finalicemos este proceso, podremos observar en el explorador de so- 
luciones que se ha añadido un nuevo fichero de recursos, Forml.en.resx, que con- 
tiene los recursos en inglés. 
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Explorador de soluciones ~q x] 
SAELE 
[od Solución 'InfoCulturawWin' (1 proyecto) 
a a InfoCulturaWin 
B- LS Properties 
#) AssemblyInfo,cs 
E- ¿4 Resources.resx 
%] Resources Designer.cs 
S- [El Settings.settings 
e] Settinas.Designer.cs 
w- (aj References 
a- ES] Form1.cs 
2] Form1 .Designer.cs 
2] Form1.en.resx 
2] Formi.resx 
ce] Program.cs 








[Explorador de soluciones [2 vista de clases 


En este instante (propiedad Language con valor English) estamos visualizan- 
do el formulario en la versión inglés. Si cambiamos el valor de la propiedad Lan- 
guage a “Predeterminado - Default”, volveremos a la versión en español. 


Una vez finalizado el diseño del formulario principal en sus distintos idiomas, 


haremos lo mismo con el resto de los formularios de la aplicación; en nuestro ca- 
so, con el formulario “Acerca de”: 


Acerca de InfoCulturaWin About of InfoCulturaWin 


Globalización y localización Globalization and localization 


[c] Fco. Javier Ceballos, 2006 


[c] Fco. Javier Ceballos, 2006 





Los controladores para las órdenes “Salir” y “Acerca de” serán los siguientes: 


private void ArchivoSalir_Click(object sender, EventArgs e) 
{ 


Close(); 


private void AyudaAcercaDe_Click(object sender, EventArgs e) 
{ 

AcercaDe dlg = new AcercaDe(); 

dlg.Show(); 
} 
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Mostrar recursos específicos 


Para mostrar los recursos de la aplicación bajo una referencia cultural determinada 
utilizaremos el siguiente código: 


using System.Globalization; 
using System.Threading; 

// 
Thread.CurrentIhread.CurrentCulture = new Culturelnfo("en-US"); 
Thread.CurrentIhread.CurrentUlCulture = new Culturelnfo("en-US"); 








La asignación del objeto CultureInfo deberá hacerse antes de invocar al mé- 
todo InitializeComponent, ya que el gestor de recursos ResourceManager de- 
terminará qué recursos recuperar en función de la propiedad Cultureln- 
fo.CurrentUlCulture del subproceso actual. La clase ResourceManager pro- 
porciona acceso a recursos específicos de la referencia cultural en tiempo de eje- 
cución. 


En nuestro ejemplo, este proceso tendremos que ejecutarlo desde las órdenes 
“Español” e “Inglés” del menú “Opciones”: 


private void OpcionesIdiomaEspañol_Click(object sender, EventArgs e) 
( 
Thread.CurrentIhread.CurrentCulture = new Culturelnfo("es-ES"); 
Thread.CurrentIhread.CurrentUlCulture = new Culturelnfo("es-ES"); 
this.Controls.Clear(); 

this.InitializeComponent(); 








private void OpcionesIdiomalnglés _Click(object sender, EventArgs e) 


Thread.CurrentIhread.CurrentCulture = new Culturelnfo("en-US"); 
Thread.CurrentIhread.CurrentUlCulture = new Culturelnfo("en-US"); 
this.Controls.Clear(); 

this.InitializeComponent(); 








} 


Obsérvese que antes de invocar al método InitializeComponent eliminamos 
los controles actuales del formulario (colección Controls), porque si no, al crear- 
los de nuevo, se duplicarían. 


Agregar ficheros de recursos de forma manual 


Ficheros análogos a Forml.en.resx pueden ser también añadidos y editados ma- 
nualmente. Para ello, simplemente hay que hacer clic con el botón secundario del 
ratón en el nombre del proyecto y seleccionar Agregar nuevo elemento del menú 
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contextual. Seleccionar en el diálogo que se visualiza la plantilla Archivo de re- 
cursos y escribir un nombre para el fichero .resx. Finalizar haciendo clic en el bo- 
tón Aceptar. El nombre del fichero tendrá la sintaxis siguiente: 


RaízDelNombre.idioma-region.resx 


El fichero se agregará al proyecto en el Explorador de soluciones y se abrirá 
automáticamente el diseñador que le permitirá editar el fichero. Se obtendrá acce- 
so a estos recursos cada vez que la aplicación no pueda encontrar recursos más 
adecuados para la referencia cultural de la interfaz de usuario. 


En cualquier instante durante el diseño, podemos abrir y editar un fichero 
.resx haciendo clic con el botón secundario del ratón en el nombre del mismo y 
seleccionando Ver diseñador en el menú contextual. 


Como ejemplo, vamos a añadir los ficheros .resx con los recursos especifica- 
dos a continuación: 





Nombre del fichero .resx Nombre del recurso Valor 
Forml.es-ES.resx cad01 Hola 
Forml.en-US.resx cad01 Hello 





La cadena de caracteres nombrada cad01 será mostrada en la caja de texto de 
Forml cuando el usuario haga clic en el botón Aceptar. 


El fichero Form1.es-ES.resx contendrá recursos que son específicos del espa- 
ñol hablado en España, y el fichero Form1.en-US.resx contendrá recursos que son 
especificos del inglés hablado en EEUU. 


Para acceder a estos recursos, añada a Forml el controlador del evento Click 
del botón y edítelo como se indica a continuación: 


using System.Resources; 
/1 


private void btAceptar_Click(object sender, EventArgs e) 
{ 
ResourceManager rm = new ResourceManager("InfoCulturaWin.Form1", 
typeof(Forml).Assembly):; 
TextBox1.Text = rm.GetString("cad01"); 
) 


El constructor de ResourceManager toma dos argumentos: raíz del nombre 
de los recursos, es decir, el nombre del fichero de recursos sin la referencia cultu- 
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ral ni la extensión .resx, y el ensamblado principal. Obsérvese que para el nombre 
del fichero se ha especificado el espacio de nombres. 


Para acceder al recurso String cad01 especificado en la referencia cultural ac- 
tual, se invoca al método GetString de ResourceManager. 


De forma predeterminada, el objeto ResourceManager distingue entre ma- 
yúsculas y minúsculas. Si no se desea hacer esta distinción, hay que asignar true a 
la propiedad IgnoreCase de ResourceManager. 


Si ahora compila y ejecuta la aplicación y hace clic en el botón Aceptar de 
Forml, observará que la caja de texto mostrará el recurso cad01 correspondiente 
al idioma elegido. 


¿Por qué no hemos añadido estos recursos a los ficheros .resx generados au- 
tomáticamente cuando diseñamos la aplicación? Porque al ser administrados por 
el diseñador de formularios, los recursos que introduzcamos serán eliminados la 
próxima vez que el diseñador modifique esos ficheros. 


Como alternativa, podríamos añadir estos recursos al fichero Resources.resx 
del proyecto, pero entonces tendríamos que especificarlos de forma análoga a co- 
mo se indica a continuación: 





Nombre del fichero .resx Nombre del recurso Valor 
Resources.resx cad01_es Hola 
Resources.resx cad01_en Hello 





Ahora, para acceder a estos recursos, tendríamos que escribir el controlador 
del evento Click así: 


using System.Resources; 
/1 


private void btAceptar_Click(object sender, EventArgs e) 
( 
System.Resources.ResourceManager rm = 
new System.Resources.ResourceManager( 
"InfoCulturaWin.Properties.Resources", typeof(Forml).Assembly):; 














if (Culturelnfo.CurrentUlCulture.Name == "es-ES") 
TextBox1.Text = rm.GetString("cad01_es"); 

else 
TextBox1.Text = rm.GetString("cad01_en"); 
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.NET PARA LINUX 


Los desarrolladores sobre GNU/Linux pueden ahora también desarrollar aplica- 
ciones multiplataforma basadas en .NET gracias al proyecto Mono. 


¿Qué es Mono? Es un proyecto para construir una plataforma de desarrollo li- 
bre, multiplataforma, compatible con Microsoft NET. Durante su desarrollo, ha 
contado con el apoyo de algunos pesos pesados de la industria informática, sobre 
todo del mundo Linux. Es el caso de Ximian, empresa dirigida por el mejicano 
Miguel de Icaza, que se mostró interesada en colaborar con el desarrollo de este 
entorno de programación desde el principio. Más tarde, la compañía norteameri- 
cana Novell adquirió esta empresa y se constituyó en uno de sus principales pa- 
trocinadores. 


Mono, en su versión 3.x, incluye un compilador para C# y bibliotecas de eje- 
cución (runtimes) para CA, entre otros lenguajes, así como otras herramientas de 
ayuda al desarrollo de aplicaciones multiplataforma (cross-platform, para varias 
computadoras/sistemas operativos). 


Mono 3.x se encuentra disponible para Linux, Mac OS X y Windows. Para 
más detalles sobre el futuro de este proyecto visite la página Web 
http://www.mono-project.com. En esta página encontrará también un enlace, 
Downloads, desde el cual podrá descargarse el software correspondiente a Mono 
para las distintas plataformas anteriormente comentadas, así como instrucciones 
para su utilización. 


Si está interesado en desarrollar sobre una máquina Linux utilizando Mono, 
puede encontrar información precisa y ejemplos en mi libro Aplicaciones .NET 
multiplataforma (proyecto Mono); este libro no es más que una extensión a esta 
enciclopedia para que vea cómo puede aplicar lo aprendido en la misma, sobre 
una máquina Linux con Mono. 
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BindingList, propiedades, 562 

BindingListView, 476, 686 

BindingManagerBase, 446 

BindingNavigator, 597 

BindingSource, 437, 439, 445, 456, 459, 465, 
468, 552, 589, 592, 623 
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Bindltem, 774 

Bitmap, 294, 320 

bloquear los controles, 29 

BMP, 319 

body, 1089 

Bold, 364 

border, 1103 

borrar datos, 930 

borrar registros en una tabla, 497 
borrar tabla de la base de datos, 497 
borrar un control, 27 

borrar un registro, 595 

botón borrar, 1099 

botón de opción, 24, 186, 1098 
botón de pulsación, 23, 56, 82 
botón enviar, 1099 

botón predeterminado, 83, 85, 175 
br, 1090 

Brush, 299 

bucle de mensajes, 47 

buscar en una lista, 192 

buscar un registro, 595 

Button, 53, 81, 82 

ButtonBase, 81 


CA, 982 

Cache, 834 

caché, 830 

caché con SQL Server, 834 

cadena de conexión, 720 

cadena de consulta, 824 

caja de clave de acceso, 1098 

caja de diálogo Abrir, 215 

caja de diálogo Color, 218 

caja de diálogo Fuente, 219 

caja de diálogo Guardar, 217 

caja de diálogo modal o no modal, 170 
caja de diálogo modal, cerrar, 178 
caja de diálogo no modal, cerrar, 234 
caja de diálogo para mostrar un mensaje, 170 
caja de diálogo, crear, 174 

caja de diálogo, mostrar, 176 

caja de diálogo, recuperar datos, 177 
caja de herramientas, 22 

caja de imagen, 24, 318 

caja de imagen, Image, 323 

caja de texto, 24, 82, 1097 

caja de texto multilínea, 139 
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caja de texto, seleccionar el contenido, 90 


cajas de diálogo estándar, 214 

cajas de diálogo personalizadas, 173 
calculadora, 106 

calendario, 25 

callback, 1024 

cambios en los datos, 688 

cambios en los datos, notificar, 437 
cambios, seguimiento, 710 

campos, 493 

Cancel, 96 

cancelar una llamada asíncrona, 1053 
CancelAsync, 410 

CancelButton, 175, 368 

CancelEdit, 557 

CancelEventArgs, 96 
CancellationPending, 410 

CanRedo, 361 

CanUndo, 144, 154, 361 

capa de acceso a datos, 545 

capa de lógica de negocio, 550 

capa de presentación, 540 

capa de presentación, desacoplar, 556 
capa de presentación, lógica, 553 
capas de servicios de la red, 1082 
cargar imagen, 322 

carpeta virtual, 759 

carpetas ASP.NET, 796 

cascada, 362 

cascada, operaciones en, 701 

casilla de verificación, 24, 182, 1098 
Category, 379 

CellBeginEdit, 556 

CellClick, 251 

CellDoubleClick, 488 

CellEnter, 472 

CellFormatting, 245 

Cells, 242 

CellValidated, 483 

CellValidating, 483 

center, 1095 

CenterParent, 175 

centrar ventana, 281 

cerrar, 44 

cerrar formulario, 129 

certificado de cliente, 983, 986 
certificado de cliente es rechazado, 988 
certificado del servidor, 981, 984 
certificados, generar o solicitar, 983 
CGI, 1110 


ChangePassword, control, 971 
ChangeTracker, 690, 711 

chat, 935 

CheckBox, 53, 81, 182 

Checked, 153, 183, 187, 192 
CheckedChanged, 185, 191 
CheckedListBox, 196 
CheckOnClick, 153 

CheckState, 183 
CheckStateChanged, 186 

ciclo de vida de un formulario, 62 
ciclo de vida de una aplicación, 70 
ciclo de vida de una página web, 802 
clase, 57 

clase Application, 51 

clase Binding, 435 

clase Bitmap, 294, 320 

clase Button, 53 

clase Cache, 834 

clase CheckBox, 53, 182 

clase CheckedListBox, 196 

clase Clipboard, 142 

clase Color, 110 

clase ColorDialog, 218 

clase ColorMatrix, 316 

clase ComboBox, 54, 197 

clase ConfigurationManager, 845 
clase Control, 82 

clase Convert, 190 

clase ConvertEventArgs, 441 
clase Culturelnfo, 1114 

clase Cursor, 327 

clase Cursors, 327 

clase DataGridView, 240 

clase DataGridViewColumn, 241 
clase DataGridViewRow, 241 
clase DataRow, 505 

clase DataTable, 505 

clase DbContext, 675 

clase de entidad, 673, 715 

clase Debug, 129 

clase EventWaitHandle, 416 
clase FontDialog, 220 

clase Form, 48 

clase Graphics, 294 

clase GroupBox, 186 

clase Image, 320 

clase Label, 53 

clase ListBox, 54, 191 

clase ListView, 267 


clase Membership, 973 

clase MembershipUser, 973 
clase MenusStrip, 126 

clase Metafile, 320 

clase OpenFileDialog, 215 
clase Page, 802 

clase Panel, 186 

clase Point, 55 

clase ProgressBar, 206 

clase RadioButton, 54, 186 
clase Regex, 103, 442 

clase ResourceManager, 132 
clase ScrollBar, 54, 202 

clase seriable, 228 

clase Size, 50, 55 

clase TextBox, 53, 141 

clase TextBoxBase, 143 

clase Thread, 398 

clase Timer, 223 

clase TimeSpam, 224 

clase ToolStrip, 121 

clase ToolStripButton, 135 
clase ToolStripltem, 121 
clase ToolStripltemCollection, 127 
clase ToolStripMenultem, 126 
clase ToolStripSeparator, 128 
clase TrackBar, 205 

clase TreeNode, 253 

clase TreeView, 252 

clase Type, 261 

clase UserControl, 375, 996 
clase WaitHandle, 415 
clases, 9 

clases POCO, 716 

clave de un nodo, 253 

clave pública, 979 

Clear, 144, 195 

ClearError, 859 
clearTimeout, 1031 

clic en un botón, 474 

clic en un botón, simular, 118, 595 
Click, 46, 87 

Client certificate revoked, 988 
cliente servidor, 741 

cliente WCF, 902 
ClientScript, 1037 

ClientSize, 50 

ClientWins, 708 

clipboard, 326 

Clipboard, 142 
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Close, 64, 129, 178, 181, 510 
CLR, 9 
CLS, 6 
code, 1091 
Code First, 715 

ingeniería inversa, 729 
Code First, convenciones, 719 
CodeFile, 799 
código administrado, 11 
código intermedio, 9 
código no administrado, 11 
colección, 162 
colección como origen de datos, 444 
colección ConstraintCollection, 505 
colección ControlBindingsCollection, 590 
colección DataColumnCollection, 505 
colección DataRelationCollection, 505 
colección DataRowCollection, 505, 594 
colección DataTableCollection, 505 
colección de elementos, 24 
colección jerárquica, 25 
colección, añadir, 195 
colección, borrar, 195 
colección, borrar todo, 195 
colección, insertar, 195 
colocar el control, 29 
Color, 110, 218, 297 
color, establecer, 110 
Color, propiedad, 219, 220 
ColorDialog, 214, 218 
ColorMatrix, 316 
columnas, 493 
ColumnCount, 252 
Columns, 241 
Columns de ListView, 270 
COM, 12 
COM+, 13 
combinar menús, 345 
ComboBox, 54, 81, 197 
Command, 506, 509 
CommandBuilder, 537 
CommanoField, 884 
CommandName, 783 
CommonDialog, 214 
compilador JIT, 11 
Complete, 624 
Component, 80 
componente, 80 
componentes de acceso a datos, 539 
concurrencia, 566, 703, 914 
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ConcurrencyCheck, 705 
ConcurrencyMode, 703 
conexión abierta/cerrada, 675 
conexión, probar, 514 
configuración de la aplicación, 67 
configuración, fichero, 536, 947 
configurar el almacenamiento en caché, 831 
configurar IIS, 948 
Configuration, 712, 947 
ConfigurationManager, 536, 845 
confirmar, 172 

conjunto de datos, 504 
conjunto de datos, crear, 577 
Connection, 506 
ConnectionStrings, 536, 845 
ConstantExpression, 643 
Constraint, 505 
ConstraintCollection, 505 
construir controles, 373 
consultas parametrizadas, 856 
contenedor, 24 

contenedor UpdatePanel, 1048 
contenedor UpdateProgress, 1052 
Content, 937, 992, 1044 
ContentAlignment, 54 
ContentPlaceHolder, 991, 1044 
ContextMenusStrip, 159, 485 
contexto de objetos, 673, 674 
contextos de corta duración, 687 
contract, 900 

contrato, 893 

contrato de datos, 898 

contrato de servicio, 894 
Control, 80, 81, 181 

control Button, 750 

control Calendar, 751 

control ChangePassword, 971 
control CheckBox, 748 

control CheckBoxList, 748 
control CreateUserWizard, 967 
control DataGridView, 578, 584 
control de usuario, 379 

control DetailsView, 1046 
control DropDownList, 750 
control GridView, 973, 1045 
control HyperLink, 751 

control ImageButton, 750 
control Label, 748 

control LinkButton, 750 

control ListBox, 749 


control Literal, 996 

control Login, 958 

control LoginName, 971 

control LoginStatus, 959 

control LoginView, 959 

control Panel, 751 

control PasswordRecovery, 970 

control RadioButton, 749 

control RadioButtonList, 749 

control RichTextBox, 352 

control ScriptManagerProxy, 1048 

control SqlDataSource, 1044 

control Substitution, 832 

control Table, 751 

control TextBox, 748 

control web para acceso a datos, 838 

Control, atributo proveedor de valor, 866 

control, borrar, 27 

control, mover, 27 

Control.DataBind, 771 

controlador de eventos, 30, 60 

controladores de espera, 415 

controladores de eventos, asignar, 61 

ControlBox, 175 

controles, 45, 1097 

controles con enlaces a datos, 752 

controles de rango definido, 201 

controles de servidor HTML, 745 

controles de servidor web, 745 

controles de usuario, 746 

controles de usuario web, 994 

controles de validación, 745, 752, 811 

controles HTML, 746 

controles para inicio de sesión, 958 

controles Strip, 321 

controles web, 747 

controles, construir, 373 

controles, enlazar o vincular con BD, 588 

Controls, 55 

ControlUpdateMode, propiedad, 435 

conversión de datos, 115 

conversiones en enlaces, 439 

Convert, 88, 190 

ConvertEventArgs, 441 

ConvertEventHandler, 440 

convertir un DateTime en un String y viceversa, 
387 

convertir un entero en base 10, 8 o 16, en una 
cadena de caracteres, 191 


convertir una cadena de caracteres a un entero 
en base 10, 8 o 16, 190 

cookies, 822 

coordenadas, 311 

coordenadas universales, 331 

coordenadas, tipos, 315 

coordinador de transacciones distribuidas, 625 

Copy, 144 

correo electrónico, 1085 

cortar, copiar y pegar, 359 

Count, 446, 592, 638 

crear un adaptador, 572 

crear un enlace, 437, 447 

crear una aplicación, 16 

crear una aplicación MDI, 344 

crear una base de datos, 494, 499, 501 

crear una caja de diálogo, 174 

crear una conexión, 577 

crear una imagen a partir de un fichero, 258 

crear una tabla, 494 

CREATE DATABASE, 494 

CREATE TABLE, 494 

CreateDatabaselfNotExists, 723 

CreateGraphics, 296 

CreateUser, 973 

CreateUserWizard, control, 967 

credentials, 955 

criptografía asimétrica, 979 

criptografía simétrica, 979 

CRL, 988 

CRUD, 719 

CSDL, 656 

CSS, 993, 1021, 1043, 1104 

CSS, atributos, 1104 

CSS, class, 1106 

CSS, div, 1108 

CSS, id, 1107 

CSS, link, 1105 

CSS, pseudoclases, 1107 

CSS, span, 1108 

CSS, style, 1104 

cuadro combinado, 197 

cultura, 1114 

Culturelnfo, 1114 

CurrencyManager, 446, 459 

Current, 446, 595 

CurrentCell, 251 

CurrentCellAddress, 251 

CurrentCulture, 1115 

Currentltem, 470, 478 
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CurrentUlCulture, 1115 
CurrentValues, 713 

Cursor, 328 

cursor del ratón, cambiar, 328 
Cursors, 327 

curvas cardinales y de Bézier, 305 
Cut, 144 


D 


Data Mapper, 661 

Data Transfer Object, 540 

DataAdapter, 506, 580 

DataAdapter, métodos, 567 

Database, 720 

Database First, 664, 715 

DataBind, 770, 772 

DataBinder, 773 

DataBindings, 436, 588 

DataColumn, 505, 586 

DataColumnCollection, 505 

DataContract, 898 

DataError, 482 

DataGridView, 81, 240, 461, 465, 540, 552, 553, 
578, 584 

DataGridView, arquitectura, 241 

DataGridView, construir, 242 

DataGridView, control de errores, 481 

DataGridView, iniciar, 244 

DataGridView, n.2 de filas y columnas, 252 

DataGridView, origen de datos, 247 

DataGridView, tamaño de las celdas, 250 

DataGridView, validar, 566 

DataGridView, valor de la celda, 251 

DataGridViewColumn, 241 

DataGridViewRow, 241 

DataMember, 468, 578, 769, 898 

DataReader, 506, 510 

DataRelationCollection, 505 

DataRow, 505 

DataRowCollection, 505, 594 

DataRowView, 435, 595 

DataSet, 435, 566, 586 

DataSet, métodos, 567 

DataSource, 446, 449, 466, 529, 568, 578, 769 

DataSource de DataGridView, 248 

DataSourcelD, 769 

DataSourceObject, 769 

DataSourceUpdateMode, propiedad, 435 

DataTable, 435, 505, 586 
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DataTableCollection, 505 
DataTextField, 769 
DataTextFormatString, 770 
DataValueField, 770 
DataView, 435, 476 
DataViewManager, 435, 586 
DateTime, 381, 387 
DateTimeFormatinfo, 387 
DateTimePicker, 210 
DbCommand, 533 
DbCommandBuilder, 537 
DBConcurrencyException, 575 
DbConnection, 533 
DbContext, 662, 671, 715 
DbDataAdapter, 533 
DbEntityEntry, 690, 696, 712, 783, 871 
DbProviderFactories, 533 
DbProviderFactory, 507, 533 
DbQuery, 662 

DbSet, 662, 671 

DbSet< >, 675 
DbSet<TEntity>, 663 
DbUpdateConcurrencyException, 703 
DCOM, 13 

Deactivate, 63 

Debug, 129 

debugger, 1078 
defaultRedirect, 859 
definición parcial, 86 
delegado, 60, 383 

delegado Func, 637 
delegados, 401, 635 

Delete, 595, 841 

DELETE, 497 
DeleteCommand, 511 
Deleted, 505 

DeleteMethod, 780 
depuración, 129 

depurar, 1069 

depurar una aplicación, 33 
descripción abreviada, 56, 57 
Description, 379 

deshacer, 144, 154, 352, 360 
deslizador, 205 

Detach, 915 

DetailsView, 854, 869, 887, 1046 
DHTML, 1022 

diálogo Acerca de, 179 
diálogo modal, cerrar, 178 
diálogo no modal, 232 


diálogo no modal, cerrar, 234 

diálogo, ¿está visible?, 236 

diálogo, acceso a la ventana padre, 233 
diálogo, ocultar, 234 

DialogResult, propiedad de un botón, 177 
DialogResult, propiedad de un formulario, 177 
DialogResult, valor retornado..., 172 
dibujar formas, 341 

dirección, 893 

dirección de Internet, 1084 

dirección IP, 1084 

directorio virtual, 759 

dirigirse a otra URL, 958 

diseño de tipo maestro-detalle, 466, 598 
DisplayMember, 449, 529, 568 
Dispose, 50, 178, 181, 518 

dispositivos matriciales y vectoriales, 292 
DNS, 1083 

doble búfer, 337 

Dock, 140, 221 

documento XML, 1029 

DoEvents, 417 

DOM, 1022 

dominio, 1083 

DoubleBuffered, 337 

DoWork, 407 

DrawArc, 304 

DrawBezier, 305 

DrawCurve, 305 

DrawEllipse, 303 

DrawLine, 302 

DrawPie, 304 

DrawPolygon, 304 

DrawRectangle, 302 

DROP TABLE, 497 
DropCreateDatabase..., 723 
DropDown, 161 

DropDownltems, 162 

DropDownList, 769 
DropDownOpening, evento, 152 
DropDownStyle, 197 

DTC, 625 


E 


editar un recurso, 69, 130 

editor de menús, 124 

editor de texto MDI, 348 

editor de textos, 138 

ejecución asíncrona de servicios web, 908 


ejecutar, 22 

Elapsed, 224 

Elapsed, evento, 223 

elemento actual, 470, 478 

elemento de un menú, marcar, 154 

eliminar filas, 699 

eliminar un recurso, 131 

EM_FORMATRANGE, 391 

e-mail, 1085 

Email, 977 

EnableAutoDragDrop, 366 

Enabled, 153 

EnablePageMethods, 1059 

EnablePartialRendering, 1041 

EndEdit, 558 

Endinvoke, 402 

endpoint, 900 

EndUpdate, 157, 192 

enfocar un componente, 89 

enlace a colecciones, 446 

enlace con otros controles, 439 

enlace de datos .NET, 427, 434, 585 

enlaces, 893, 901, 1093 

enlaces de datos en ASP.NET, 771 

Enter, 90 

entidad, 668 

Entity Client, 658 

Entity Framework, 656 

Entity SQL, 658 

EntityCollection, 676 

EntityDataSource, 847 

EntityDataSourceView, 861 

EntityKey, 710 

EntitySet, 710 

entorno de desarrollo integrado, 1065 

entorno de ejecución, 9 

entrada de datos, 1097 

Entries, 708 

Entry, 690, 712, 783, 871 

enumeración ContentAlignment, 54 

enumeración Keys, 130 

error, notificar, 97 

errores en una página ASP.NET, controlar, 859, 
873 

errores, control en DataGridView, 481 

ErrorProvider, 97 

ErrorText, 484 

escribir datos en una tabla, 496 

espacios de nombres, 32 

especificación de lenguaje común, 6 
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eSQL, 658 

esquinas redondeadas, 999 
estado de aplicación, 828 
estado de sesión, 828 

estado de un hilo, 399 

estado de una página, 821 
estado de vista, 825 

estado del modelo, 785 

estilo del texto, 364 
estructura de una aplicación gráfica, 48 
etiqueta, 23, 54 

etiquetas, 82 

etiquetas HTML, 1089 

Eval, 773 

EventArgs, 384 
EventHandler, 60, 405 
evento, 46, 62 

evento ApplicationExit, 71 
evento CellBeginEdit, 556 
evento CellFormatting, 245 
evento Click, 87 

evento Enter, 90 

evento FormClosing, 365, 580 
evento Idle, 71 

evento KeyPress, 87 

evento Load, 89, 579 

evento MouseClick, 91 
evento Paint, 292 

evento Prelnit, 1002 

evento PrintPage, 358 
evento PropertyChanged, 431 
evento Selecting, 856 

evento SelectionChange, 363 
evento Shown, 89 

evento TextChanged, 87, 430 
evento ThreadException, 71 
evento ThreadExit, 71 

evento UserDeletingRow, 555 
evento Validated, 98 

evento Validating, 97 

evento, suscribir, 30 

eventos, 30, 59, 383 

eventos del ratón, 332 
eventos del teclado, 86 
eventos KeyDown, KeyUp y KeyPress, 94 
eventos más comunes, 60 
eventos, implementar, 383 
eventos, lista, 30 

eventos, responder, 86 
EVENTVALIDATION, 827 
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EventWaitHandle, 412, 416 
ExecuteNonQuery, 509 
ExecuteReader, 509 

EXIF, 319 

Exit, 51 

explorador de bases de datos, 501 
expresión de consulta, 640, 644 
expresión de consulta, compilación, 647 
expresiones de enlace de datos, 772 
expresiones lambda, 635 
expresiones regulares, 100, 442 
Expression, 641, 643 

extremo, 893 


factoría, 533 

fecha y hora, 25 

fecha y hora, formato, 381 
fechas, 209 

fichero de configuración, 535, 536, 845, 947 
fichero de recursos, 133, 1116 
fila añadir, 595 

fila nueva, 594 

filas, 493 

FileDialog, 214 

FileName, 217 

FileUpload, 916 

Fill, 512, 567, 579 

Filter, 217 

FilterIndex, 217 

filtrado, 881 

filtro de nombres de fichero, 217 
finalizar la ejecución, 22 
finally, 515 

Find, 253, 352, 595 
FindString, 157, 192 

firma digital, 980 
FixedDialog, 175 

FlatStyle, 183, 187 

flow layout, 800 
FlowLayoutPanel, 210, 211 
Fluent API, 727 

foco, 89, 227, 595 

Focus, 89, 191, 595 
FolderBrowserDialog, 215 
font, 1089 

Font, 54, 109, 301 
FontDialog, 215, 220 
foreach, 229 


ForeColor, 110 

FOREIGN KEY, 585 

form, 816, 1096 

Form, 48, 81 

Format, 88 

Format de String, 381 

Format, evento, 436, 439 
FormatException, 88 

formatos de fechas y horas, 381 
FormBorderStyle, 66, 175 
FormClosed, 63 

FormClosing, 63, 365, 580 
FormClosing, evento, 178 
FormsAuthentication, 958 
formulario Acerca De, 327 
formulario activo, 62, 346 
formulario cargar, 579 
formulario cerrar, 580 
formulario hijo, 350 

formulario MDI, 348, 615 
formulario modal, 62 
formulario no modal, 62 
formulario propietario, 180 
formulario web, diseño, 753 
formulario, Backgroundlmage, 323 
formulario, cerrar, 365 
formulario, posición inicial, 63 
formularios, 45, 1096 
formularios hijo, 346 
formularios hijo abiertos, 345, 362 
formularios web, 791, 816 
formularios, colección, 62 
formularios, comunicación entre, 232 
FormView, 783, 876 

from, 638, 646 

FromaArgb, 110 

FromFile, 323 

Fromimage, 310 

ftp, 1084, 1086 

fuente, establecer, 109 
FullPath, 253 

Func, 637 

funciones, representar, 328 
fusionar barras de herramientas, 371 


G 


GDI+, 291 
GDI+, servicios, 293 
generador de código nativo, 12 


generar código JavaScript, 1034 
gestión de datos, 741 

gestor de recursos, 1119 

get, 816 

GetAllUsers, 976 

GetCurrent, 945 
GetCustomAttributes, 70 
GetDatabaseValues, 713 
getElementsByTagName, 1029 
GetExecutingAssembly, 70 
GetObject, 68, 132 

GetString, 68, 132, 1121 
GetType, 261 

GetView, 862 

GIF, 319 

Global.asax, 814 
globalización, 1113 

Gopher, 1084 

GotFocus, 227 

gráficos, 291 

gráficos en un documento HTML, 1094 
gráficos vectoriales, 293 
Graphics, 296, 340 
GraphicsPath, 302, 306 

grid layout, 800 

GridView, 777, 882, 1045 
GridView, AllowSorting, 881 
GridView, SelectedValue, 884 
group, 649 

group ... by, 638 

GroupBox, 81, 186, 189 

grupo de aplicaciones, 763, 942 
grupos de noticias, 1086 
guardar documento, 355 
guardar una aplicación, 32 
guardar una imagen, 324 


H 


habilitar o inhabilitar los elementos de un 
menú, 152 

Handled, 87 

HashSet, 718, 733 

HasMorePages, 359 

head, 1089 

height, 1095 

herramientas, caja, 22 

hidden, 825 

Hide, 64, 234 

hilo en segundo plano, 400 


ÍNDICE 1135 


hilos, 393 

hilos accediendo a controles de los formularios, 
401 

hilos secundarios, detener de forma 
controlada, 417 

hilos, cancelar, 410 

hilos, estados, 400 

hilos, mecanismos de sincronización, 411 

hipertexto, 1093 

hn, 1090 

hoja de estilo, 993, 1043, 1104 

hr, 1090 

href, 1093 

HScrollBar, 81, 202 

html, 8, 1088, 1089 

HTML, controles, 745, 746 

HtmlinputHidden, 825 

HTTP, 8, 821, 1085 

HTTP 403.13, 988 

HTTP get, 817 

HTTP post, 818 

HttpClientCertificate, 983 

HttpContext, 820, 945 

HttpCookie, 822 

http-equiv, 937 

HTTPS, 982, 986 

HttpServerUtility, 820 

HyperLink, 858, 872 


I 


IBindingList, 435, 437, 444, 452, 474 
IBindingListView, 475 

Icon, 29, 65 

icono de la aplicación, 29 
IDatabaselnitializer, 723 
Identity, 723, 916, 944 
IDictionary, 862 

idioma, 1114 

IDisposable, 518 

Idle, 71 

lEditableObject, 557 
lEnumerable, 445, 639, 653 
iframe, 1095 

IgnoreCase, 1121 

IIS, 760, 939 

IIS 7.0, certificados, 983 

IIS, instalar, 1112 

IList, 435, 444 

Image, 320 
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Image, propiedad, 133 
Imagelndex, 255, 256 

ImageList, 255 

imagen, 324, 1099 

imagen en un botón, 130 

imagen, cargar, 322 

imágen, FromFile, 258 

imagen, guardar, 324 

imágenes, 294 

imágenes en un documento HTML, 1094 
imágenes, lista de, 255 

Images, 255 

ImageStream, 256 
ImageTransparentColor, 133 
IMAP, 1084 

img, 1094 

imprimir documento, 357 
incoherencia de accesibilidad, 230 
Increment, 207 

Inherits, 799 
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líneas de ayuda, 29 

LINQ, 631 

LINQ to Entities, 657 

Linux, 1123 

List, 447 
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lista de tareas, 134 
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lógica de negocio, 741 
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módem, 1085 
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modificar datos, 688 
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Mutex, 72, 412 


N 
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ObjectStateEntry, 689, 710 
ObjectStateManager, 689, 710 
objeto de negocio, 925 
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objetos como orígenes de datos, 459 
objetos de negocio, 542 
objetos de sincronización, 411 
OdbcConnection, 507 
OdbcDataAdapter, 511 

ol, 1092 
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OleDbDataAdapter, 511 
OleDbDataReader, 510 
onchange, evento, 1028 
onreadystatechange, 1025 
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OpenFileDialog, 215, 218 
OpenForms, 62 
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OperationContract, 894 
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OracleDataAdapter, 511 

orden, 511 

orden de tabulación, 1100 

orden parametrizada, 523 

orden SQL, escribir una nueva, 621 
orden Tab, 55, 90, 279 
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orderby, 638, 646 

organizar iconos, 362 

Orientation, 205 

origen de datos, 444, 462, 601 
orígenes de datos ADO.NET, 445, 586 
orígenes de datos, ventana, 462 
OriginalValues, 713 

ORM, 655, 716 
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OutputCache, 831 

override, 50 

OwnedForms, 181 
OwnedWindows, 64 

Owner, 65, 181, 232, 233 
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p, 1090 
padre-hija, tablas, 599 

Page, 802, 944, 1037 

Page.DataBind, 771 

Page_Error, 859 

Page_evento, 769, 803 

PageMethods, 1058 
PageRequestManager, 1053 
PageSetupDialog, 215, 392 

página de contenido, 989 

página de inicio de sesión, 956 

página maestra, 989 

página principal, 989 

página web, 799, 1088 

página web ASP.NET, 757 

página web dinámica, 1110 
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paginación, 881 

páginas ASP, 1111 

páginas web, publicar, 759 
Paint, 292, 296, 297 

Panel, 24, 186, 321, 367 

panel de dibujo, 339 

pantalla de presentación, 74 
ParameterExpression, 643 
Parameters, 523 

parámetro oculto, 825, 1099 
parámetros en órdenes SQL, 523 
parcial definición, 86 

Parse, 115 

Parse, evento, 436, 439 

partial, 86 

pasos, 237 

passport, 947 

PasswordChar, 174 
PasswordRecovery, control, 970 
Paste, 144 

patrón de diseño Factory, 533 
patrones de diseño, 661 

Pen, 298 

perfiles, 1003 

PerformClick, 118, 474, 595 
PerformStep, 207 

PictureBox, 81, 321 

plantilla, 773, 778 

plantilla de formularios, 366 
Play, 338 

PlaySync, 338 

PNG, 319 

POCO, 716 

Point, 55, 300 

pool de conexiones, 516, 946 
POP 3, 1084 

portapapeles, 142, 326 

posición de un componente, modificar, 221 
posición inicial del formulario, 63 
posición, conservar, 221 
Position, 446, 592 

post, 816 

postback, 1023, 1049 

postbacks asíncronos, 1041 
PostgreSql, 508 

precompilar la aplicación ASP.NET, 815 
Prelnit, 803, 1002 

PreRender, 803 

presentación, 741 

PRIMARY KEY, 495 


principal, 939 

Print, 358 

PrintDialog, 215, 392 
PrintDocument, 357, 392 
PrintPage, 358 

PrintPreviewDialog, 392 

Priority, 400 

problemas de concurrencia, 566 
procedimiento almacenado, 524, 541 
producto cartesiano, 650 

Profile, 1003 

ProgressBar, 81, 206 
ProgressChanged, 409 
ProgressPercentage, 409 
PropertyChanged, 431 
PropertyManager, 446 
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propiedad autoimplementada, 633 
propiedad cambió, notificar, 431 
propiedad Cancel, 96 

propiedad ClientSize, 50 
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propiedad Count, 592 

propiedad Cursor, 328 

propiedad DataBindings, 588 
propiedad DataMember, 578 
propiedad DataSource, 578 
propiedad Font, 54 

propiedad Icon, 29 

propiedad Location, 55 

propiedad Modified, 354, 365 
propiedad Name, 50 

propiedad Position, 592 

propiedad ReadOnly, 109 
propiedad Size, 50, 55 

propiedad TabStop, 55 

propiedad Tanindex, 55 

propiedad Text, 50, 54 

propiedad TextAlign, 54, 109 
propiedades, 27 

propiedades de navegación, 674 
propiedades, añadir a un control, 376, 390 
propiedades, atributos, 379 
propiedades, clasificación, 379 
propiedades, control de usuario, 376 
propietario de un diálogo, 232 
protected, 50 

protocolo, 1082 

protocolo de transferencia de ficheros, 1086 
proveedor de datos, 506 


proveedor de entidades, 658 
proveedores de LINQ, 653 
providers, 971 

proyecto, 16 

publicar páginas web, 759 
puntero, 22 

punto de inserción, 89 
punto final, 893 
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RAD, 799 

RadioButton, 54, 81, 186 
RangeValidator, 811 

raster, dispositivos, 292 
Read, 510 
ReaderWriterLock, 412 
ReadOnly, 109 

readyState, 1025 

recorte, área de, 307 
Rectangle, 300 

recursos, 130, 1116 
recursos de una aplicación, 68 
recursos embebidos, 132 
recursos vinculados, 132 
recursos, acceder, 1119, 1120 
Redirect, 821, 1019 
RedirectFromLoginPage, 958 
Redo, 352 

reescritura de la URL, 824 
refactorización, 375 
referencias, 19 

referencias culturales, 1114 
reflexión, 70 

Refresh, 451, 706 

Regex, 103, 442 

región, 306 

región de recorte, 307 
región no válida, 293 
RegisterClientScriptBlock, 1037 
RegisterStartupScript, 1037 
registros, 493 

rehacer, 352, 360 

rejilla, 578 

rejilla de ayuda, 29 

Reload, 707, 713 
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reloj despertador, 165, 236 
Remove, 195, 229 

RemoveAt, 195 

RemoveaAt, colección, 165 
rendimiento del servidor, 830 
repintar una ventana, 293 
Replace, 103 

ReportProgress, 409 
representar funciones, 328 
Request, 820 
RequiredFieldValidator, 811 
reset, 1099 

Reset, 416 

Resize, 221 

resolución gráfica, 292 
ResourceManager, 68, 132, 1119, 1120 
Response, 820, 1019 
Response.Redirect, 958 
responseText, 1025 
responseXxML, 1025 
RestoreBounds, 65 
RestoreDirectory, 217 
reutilización, 373 
RevertMerge, 351 

RGB, 110 

RichTextBox, 81, 151, 352, 391 
Row, 563 

RowCount, 252 

Rows, 241 

RTF, 352 

Run, 47 

RunWorkerAsync, 407 
RunWorkerCompleted, 407, 409 
ruta del sitio web, 820 
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SaveChanges, 675 
SaveFile, 352 

script callbacks, 1032 
ScriptManager, 1041 
ScriptManagerProxy, 1048 
ScriptPath, 1041 
scripts, 1041, 1111 
ScriptService, 1056 
Scroll, 204 

ScrollBar, 54, 81, 202 
ScrollBars, 139 
sección crítica, 413 
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seguimiento de los cambios, 710 
seguridad, 978 
seleccionar datos de una tabla, 497 


seleccionar el contenido de una caja de texto, 


90 
seleccionar el texto de una caja, 227 
seleccionar un objeto, 28 
select, 638, 646, 1100 
Select, 89, 91, 144, 595, 841, 856 
SELECT, 497 
SelectAll, 91, 144, 227 
SelectCommand, 511 
selected, 1101 
SelectedCells, 242 
SelectedColumns, 241 
Selectedlmagelndex, 255, 256 
Selectedindex, 157, 192, 193, 198, 770 
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Selectedltem, 157, 192, 198, 199, 770 
Selectedltems, 195 
SelectedNode, 253, 263 
SelectedRows, 241 
SelectedRtf, 359 
SelectedText, 91, 143, 359 
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Selecting, 856 
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SelectionChange, 363 
SelectionFont, 364 
SelectionLength, 91, 144 
SelectionStart, 91, 143 
SelectMethod, 779 
Semaphore, 412 
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señalar un elemento de un menú, 153 
separadores, 125 
seriar/deseriar un árbol, 290 
Server, 820, 859 
Services, 1041, 1056 
servicio, 891 
servicio de conexiones, 516, 946 
Servicio de red, 764, 789, 946 
servicio de suscripciones, 971 
servicio WCF, 893 
servicio WCF, configuración, 900 
servicio web, 8 
servicio web, acceso a BD, 1010 
servicios de IIS, 760 
servicios de Internet, 1085 
Servicios de objetos, 658 


servicios web con AJAX, 1054 
servicios web y LINQ, 912 
servicios web, ejecución asíncrona, 908 
servidor de nombres, 1084 
servidor SMTP de IIS, 968 
servidor web, 1112 

servlets, 1112 

Session, 820 

Set, 416, 699 

SetCacheability, 833 
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Setinitializer, 725, 731 
setTimeout, 1031 

SetToolTip, 57 

ShortcutKeys, 130 
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ShowColor, 220 

ShowDialog, 62, 173, 177, 181, 215 
ShowHelp, 219 
ShowInTaskbar, 63, 65 

Shown, 63, 89 
ShowNodeToolTips, 267 
ShowPlusMinus, 267 
ShowReadOnly, 217 
ShowRootLines, 267 
simultaneidad, 703, 914 
simultaneidad optimista, 574 
sincronización, 937 

sistema de nombres de dominio, 1083 
sitio web, 759 

sitio web, reglas de acceso, 974 
sitios web, administración, 961 
size, 1089 

Size, 50, 55, 221, 301 
SizeChanged, 221 
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Sleep, 400 

SmallChange, 202 

SMTP, 968, 1085 

SOAP, 889 

SOAP, mensaje, 892 
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sonido, 338 

Sort, 193, 198 

SortedList, 227, 229 
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SplashScreen, 74 
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Sql Server, 508, 516 
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SQL Server 2012 Express, 1071 
SQL Server Management Studio Express, 1074 
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SQLCMD, 1072 

SqlCommand, 509 
SqlCommandBuilder, 574 
SqlConnection, 507 
SqlDataAdapter, 511, 567 
SqlDataReader, 510 
SqlDataSource, 838, 1044 

src, 1094, 1096 

SSDL, 656 

SSL, 950, 981, 987 
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StartPosition, 63 
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State, 713 

status, 1025 

StatusBar, 81 

StatusStrip, 137 

statusText, 1025 

Step, 207 

StoreWins, 707 

Strikethru, 364 

subdominio, 1083 
submenú-menú contextual, 161 
submenús, 127 

submit, 1099 

Substitution, 832 

Sum, 639 

superficie de dibujo permanente, 310 
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SupportsFiltering, 474 
SupportsSorting, 474 

suscribir evento, 30 

SvcUtil.exe, 905 
System.ComponentModel, 81 
System.Data.Linq, 631 
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System.Linq.Expressions, 642 
System.Media, 338 
System.Threading, 394 
system.web, 947 

System.Web, 820 
System.Windows.Forms, 49, 80 
System.Windows.Forms.Design, 81 
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Tab, 55 

TabControl, 208 

tabindex, 1100 

Tabindex, 55, 89, 126 

tabla, 24, 239, 493, 1103 
tabla con cabecera de filas, 279 
tabla, construir, 242 

tabla, iniciar, 244 

table, 1103 

table dinámico, 1025 
TableAdapterManager, 585 
TableLayoutPanel, 211 
tablero de dibujo, 339 
TabStop, 55 

Tag, 489 

TakeWhile, 639 

tamaño de los controles, 27 
tamaño de un componente, modificar, 221 
TCP/IP, 1082 

td, 1103 

tecla de acceso, 56, 85 

tecla pulsada, interceptar, 92 
teclas, 94 

teclas Alt, Control o Shift (Mayús), 94 
telnet, 1085 

temas, 1000 

temporizador, 25, 222, 1031 
Text, 50, 54, 88, 198 
TextAlign, 54, 109 

textarea, 1100 

TextBox, 53, 81, 82, 141 
TextBoxBase, 81, 143 
TextBoxEx, 374 
TextChanged, 87, 189, 430 
texto seleccionado, 152 
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theme, 1000 

Thread, 398 
ThreadException, 71 
ThreadExit, 71 

ThreadStart, 398 
ThreadState, 400 
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Tick, evento, 223 
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ticks, 237 

TickStyle, 205 

TIFF, 320 

Timer, 223, 412, 1054 
TimeSpam, 224 

tip, 57 

tipo anónimo, 632 

tipo de un objeto, 261 

tipo enumerado, 112 

tipo implícito, 632 
tipografía, 294 

tipos de enlace, 436 

tipos SQL, 495 

title, 1089 

ToDouble, 88 

Tolnt32, 190 

ToList, 676 

ToolBar, 81 

ToolStrip, 121, 134 
ToolStripButton, 135 
ToolStripComboBox, 155 
ToolStripltem, 121 
ToolStripltemCollection, 127 
ToolStripManager, 351 
ToolStripMenultem, 126, 486 
ToolStripSeparator, 128 
ToolTip, 57 
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Topmost, 65 
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transacción, 525, 624 
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transformación, 312, 329 
transformación global, 314 
transformación local, 315 
transformaciones de color, 316 
trazado, 306 
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TreeView, 252 
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Triggers, 1050 
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Unchanged, 505 
Underline, 364 
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Unload, 803 
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UPDATE, 496 
UpdateCommand, 511 
UpdateMethod, 780 
UpdateMode, 1051 
UpdatePanel, 1048 
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URL, 743, 1092 

URL, dirigirse a otra, 958 
USENET, 1085, 1086 
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UserControl, 375 
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usuario ASPNET, 946 
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validación discreta, 813 
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validar datos, 442 
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ValidationSummary, 811 
value, 1099 

Value, 201, 207, 229, 236 
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value provider attributes, 866 
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ValueMember, 529, 569 
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varbinary, 916 
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ventana de aplicación, 344 
ventana de documento, 344 
ventana, centrar, 281 

Ventana, menú, 347, 362 
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ViewState, deshabilitar, 836 
ViewState, mecanismo, 836 

vista de colección, 476 

vista del control, 862 

vista, buscar sus elementos, 479 
vista, filtrar sus elementos, 479 
vista, ordenar sus elementos, 478 
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Visual Studio .NET, 13 

VScrollBar, 81, 202 
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WaitAll, 415 
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WaitHandle, 413, 415 
WaitOne, 415 
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web, 1086 

web, controles, 745 
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INSTALACIÓN 


Para instalar el kit de desarrollo de C# y los ejemplos de este libro descargue la plataforma de desarrollo de la di- 
rección: http://www.microsoft.com/express/. 


PLATAFORMA WINDOWS 
Instalación de NET Framework SDK 


Hay que instalar NET Framework Redistributable Package antes de instalar NET Framework SDK. El primer 
paquete incluye todo lo necesario para ejecutar aplicaciones desarrolladas con .NET Framework. El segundo pa- 
quete incorpora todo lo necesario para escribir, construir, verificar y desplegar aplicaciones desarrolladas 
con.NET Framework. 


Para realizar la instalación, siga las instrucciones mostradas por el asistente de instalación. Esta instalación se 
realiza en la carpeta Microsoft.NET de Windows y en la carpeta Microsoft. NET de archivos de programas. 


Instalación de Microsoft Visual Studio 


La instalación de Visual Studio (el paquete completo o las versiones Express que necesite) no requiere la instala- 
ción previa del SDK porque está incluido en éste. Descargue de Internet el paquete Visual Studio Express 2012, 
o bien, si tiene acceso a alguna versión profesional de Visual Studio 2012, e instálelo (opcionalmente puede ins- 
talar SQL Server Express). 

Ejemplos del libro 


Los ejemplos del libro puede instalarlos en la carpeta Projects de Visual Studio o los puede recuperar directa- 
mente desde el CD cuando los quiera consultar. La forma de descargar el CD se indica en el prólogo. 


PLATAFORMA LINUX 


Véase el apéndice D. 


LICENCIA 


Todo el contenido de este CD, excepto los ejemplos del libro, es propiedad de las firmas que los representan (Mi- 
crosoft, etc.). La inclusión en este libro se debe a su gentileza y es totalmente gratuita y con la finalidad de apo- 
yar el aprendizaje del software correspondiente. Para obtener más información y actualizaciones visite las direc- 
ciones indicadas en dicho software: 


http://www.microsoft.com/express/ 


Al realizar el proceso de instalación, haga el favor de consultar el acuerdo de licencia para cada uno de los pro- 
ductos. 


WEB DEL AUTOR: http://www. ficeballos.es 


En esta Web podrá echar una ojeada a mis publicaciones más recientes y acceder a la descarga del software nece- 
sario para el estudio de esta obra así como a otros recursos. 


Enciclopedia de Microsoft? 


Visual Cf 


4.* EDICIÓN 


C# evolucionó a partir del lenguaje C/C++ incorporando numerosas instrucciones, funciones y palabras 
clave directamente relacionadas con la interfaz gráfica de Windows. Actualmente ofrece capacidades 
para realizar un diseño completamente orientado a objetos y acceso directo a Microsoft .NET 
Framework, entorno que proporciona un amplio conjunto de interfaces de programación de aplicaciones 
para Windows e Internet. 


Desde la aparición de Visual Studio .NET, entorno de desarrollo que incluye a Visual C#, dicho paquete 
ha sido revisado y ampliamente modificado, con el único objetivo de ofrecer una herramienta flexible 
para los desarrolladores de aplicaciones de línea de negocios que crean aplicaciones Windows, web 
o móviles. Así, hemos oído hablar de Visual Studio 2002, 2003, 2005, 2008, 2010 y 2012 y .NET 
Framework 2.0, 3.5, 4.0 y 4.5. 


Al mismo tiempo, Microsoft ha publicado una gama de productos denominada Express, de descarga 
gratuita, que está enfocada a programadores no profesionales. Estos entornos de desarrollo son Visual 
Studio Express for Windows Desktop, for Web (para el desarrollo de aplicaciones web), for Windows 
Phone, etc., y SQL Server Express. Los desarrolladores profesionales podrán elegir también entre 
las versiones profesionales de Visual Studio, en las que encontrarán herramientas específicas para 
arquitectos, desarrolladores o probadores, o herramientas de software de ciclo de vida. Este software de 
desarrollo se complementa con ASP.NET AJAX para el desarrollo de aplicaciones web basadas en AJAX. 


Enciclopedia de Microsoft Visual C# es un libro totalmente actualizado con las nuevas características 
de .NET Framework 4.5, para aprender a programar escribiendo linea a línea el código de una 
determinada aplicación, o bien utilizando herramientas de diseño rápido como Microsoft Visual Studio 
2012 y SQL Server, que le permitirán crear aplicaciones cliente Windows tradicionales, componentes 
distribuidos, aplicaciones cliente-servidor, aplicaciones para acceso a bases de datos (ADO.NET), 
acceso a bases de datos utilizando Entity Framework y LINQ, aprender sobre enlaces a datos, páginas 
web y servicios WCF, crear aplicaciones para Internet (ASP.NET) basadas o no en AJAX, y muchas otras. 


Por otra parte, mi otro libro Aplicaciones .NET multiplataforma (Proyecto Mono) es una extensión a esta 
enciclopedia que le enseñará a realizar sus desarrollos .NET sobre una máquina Linux aplicando todo 
lo estudiado en esta obra. 


Podrá descargarse de www.ra-ma.es, en la página web correspondiente 

A EDO al libro, un CD-ROM con los ejemplos realizados, con los apéndices, así 
como con las direcciones para la descarga del software necesario para 
que el lector pueda reproducirlos durante el estudio. 
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